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 で実行できます。

VHF は、HID ソースドライバーが VhfStart を呼び出すまで、VHF_CONFIGで指定されたコールバック関数を呼び出しません。