Fungsi VhfCreate (vhf.h)

Artikel
02/07/2025

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

Sintaksis

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.

Mengembalikan nilai

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

Komentar

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 hingga driver sumber HID memanggil VhfStart.

Persyaratan

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

Lihat juga

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

Bagikan melalui