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에만 보고됩니다. 이 메서드가 반환되기 전에 디바이스의 초기화, 설치 및 시작이 완료되지 않을 수 있습니다.

kmDF(Kernel-Mode Driver Framework) 드라이버는 WdfDeviceCreate를 호출하여 자체 디바이스 개체를 성공적으로 만든 후 언제든지 VhfCreate를 호출할 수 있습니다. 드라이버는 EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit에서 이 작업을 수행할 수 있습니다.

VHF는 HID 소스 드라이버가 VhfStart를 호출할 때까지 VHF_CONFIG 지정된 콜백 함수를 호출하지 않습니다.