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 中指定的任何回调函数。