Fungsi KsCreatePin (ks.h)
Fungsi KsCreatePin meneruskan permintaan koneksi ke perangkat, membuat instans pin. Fungsi ini hanya dapat dipanggil di PASSIVE_LEVEL untuk klien mode kernel.
Sintaks
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 pembuatan 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 dilewati. Rutinitas mengisi ini dengan handel ke objek file dari koneksi yang dibuat. Nilai ini kemudian dapat digunakan untuk memutuskan sambungan dengan fungsi CloseHandle .
Nilai kembali
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:
Keterangan
Rutinitas mengirimkan permintaan IRP_MJ_CREATE ke driver. Driver menerima permintaan hanya jika antarmuka, sedang, dan format data kompatibel.
Jika Connect-PinToHandle> adalah NULL, KsCreatePin membuat pin yang dapat digunakan pemanggil untuk mengirim permintaan ke driver streaming yang ditentukan dalam Connect-FilterHandle>. Connect-PinId> menentukan jenis pin dari pin yang akan dibuat.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |