Fungsi KsCreatePin (ks.h)

Fungsi KsCreatePin meneruskan permintaan koneksi ke perangkat, membuat instans pin. Fungsi ini hanya dapat dipanggil pada PASSIVE_LEVEL untuk klien mode kernel.

Sintaksis

KSDDKAPI NTSTATUS KsCreatePin(
  [in]  HANDLE         FilterHandle,
  [in]  PKSPIN_CONNECT Connect,
  [in]  ACCESS_MASK    DesiredAccess,
  [out] PHANDLE        ConnectionHandle
);

Parameter

[in] FilterHandle

Menentukan handel filter yang memulai permintaan buat dan di mana koneksi akan terjadi.

[in] Connect

Penunjuk ke struktur KSPIN_CONNECT yang berisi parameter untuk koneksi yang diminta. Ini harus diikuti dalam memori oleh struktur data KSDATAFORMAT, yang menjelaskan format data yang diminta untuk koneksi.

[in] DesiredAccess

Menentukan akses yang diinginkan ke pin. Ini biasanya GENERIC_READ atau GENERIC_WRITE. Untuk data yang mengalir ke pin, nilai ini harus diatur ke GENERIC_WRITE, dan untuk data yang mengalir keluar dari pin, ini harus diatur ke GENERIC_READ terlepas dari metode komunikasi.

[out] ConnectionHandle

Menentukan handel koneksi yang diteruskan. Rutinitas mengisi ini dengan handel ke objek file koneksi yang dibuat. Nilai ini kemudian dapat digunakan untuk memutuskan sambungan dengan fungsi CloseHandle.

Mengembalikan nilai

Fungsi KsCreatePin mengembalikan STATUS_SUCCESS jika koneksi berhasil, atau mengembalikan kesalahan jika koneksi gagal. Selain itu, kode kesalahan Win32 ini (dari Winerror.h) dapat dikembalikan:

Komentar

Rutinitas mengirimkan permintaan IRP_MJ_CREATE ke driver. Driver menerima permintaan hanya jika antarmuka, sedang, dan format data kompatibel.

Jika Connect->PinToHandleNULL, KsCreatePin membuat pin yang dapat digunakan pemanggil untuk mengirim permintaan ke driver streaming yang ditentukan dalam Connect ->FilterHandle. Connect->PinId menentukan jenis pin pin yang akan dibuat.

Persyaratan

Lihat juga

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT