VhfCreate 函数（vhf.h）

HID 源驱动程序调用此方法以创建虚拟 HID 设备。

语法

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

[in] VhfConfig

指向 VHF_CONFIG 结构的指针。

[out] VhfHandle

新虚拟 HID 设备的句柄。

如果 VhfCreate 调用成功，该方法将返回STATUS_SUCCESS。否则，NTSTATUS 值。

此方法在验证 VHF_CONFIG 结构和创建虚拟 HID 设备后同步返回。虚拟 HID 设备仅报告给 PnP。此方法返回之前，设备初始化、安装和启动可能无法完成。

Kernel-Mode Driver Framework （KMDF）驱动程序可以通过调用 WdfDeviceCreate，在成功创建自己的设备对象后随时调用 VhfCreate。驱动程序可以在其 EvtDriverDeviceAdd、EvtDevicePrepareHardware、EvtDeviceD0Entry、EvtDeviceSelfManagedIoInit中执行此作。

在 HID 源驱动程序调用 VhfStart之前，VHF 不会调用在 VHF_CONFIG 中指定的任何回调函数。