Fungsi VhfCreate (vhf.h)

  • Artikel

Driver sumber HID memanggil metode ini untuk membuat perangkat HID virtual.

Sintaks

NTSTATUS VhfCreate(
  [in]  PVHF_CONFIG VhfConfig,
  [out] VHFHANDLE   *VhfHandle
);

Parameter

[in] VhfConfig

Penunjuk ke struktur VHF_CONFIG .

[out] VhfHandle

Handel ke perangkat HID virtual baru.

Nilai kembali

Jika panggilan VhfCreate berhasil, metode mengembalikan STATUS_SUCCESS. Jika tidak, nilai NTSTATUS yang sesuai.

Keterangan

Metode ini kembali secara sinkron setelah memvalidasi struktur VHF_CONFIG dan membuat perangkat HID virtual. Perangkat HID virtual hanya dilaporkan ke PnP. Inisialisasi, penginstalan, dan awal perangkat mungkin tidak selesai sebelum metode ini kembali.

Driver Kernel-Mode Driver Framework (KMDF) dapat memanggil VhfCreate kapan saja setelah berhasil membuat objek perangkatnya sendiri dengan memanggil WdfDeviceCreate. Driver dapat melakukannya di EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF tidak memanggil fungsi panggilan balik apa pun yang ditentukan dalam VHF_CONFIG sampai driver sumber HID memanggil VhfStart.

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header vhf.h
Pustaka VhfKm.lib
IRQL PASSIVE_LEVEL

Lihat juga

Menulis driver sumber HID dengan menggunakan Virtual HID Framework (VHF)