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) 驅動程式可以在任何時間點呼叫 VhfCreate ，方法是呼叫 WdfDeviceCreate 成功建立自己的裝置物件。驅動程式可以在其 EvtDriverDeviceAdd、 EvtDevicePrepareHardware、 EvtDeviceD0Entry、 EvtDeviceSelfManagedIoInit 中執行此動作。

在 HID 來源驅動程式呼叫 VhfStart 之前，VHF 不會叫用VHF_CONFIG中指定的任何回呼函式。