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