Fungsi KsCreatePin2 (ks.h)

Meneruskan permintaan koneksi ke perangkat, membuat instans pin.

Didukung mulai dari Windows 8.

Sintaksis

KSDDKAPI HRESULT KsCreatePin2(
  [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

Mengembalikan NOERROR jika berhasil; jika tidak, mengembalikan kode kesalahan.

Komentar

Ini adalah versi baru dari fungsi KsCreatePin dan menggunakan broker perangkat untuk membuat handel ke objek streaming kernel. Selain itu, fungsi Component Object Model (COM) CoInitialize harus dipanggil sebelum fungsi ini dipanggil.

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

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

Persyaratan

Lihat juga

CoInitialize

IRP_MJ_CREATE

KSDATAFORMAT

KSPIN_CONNECT

KsCreatePin