VhfDelete 함수(vhf.h)

HID 원본 디바이스 드라이버는 이 메서드를 호출하여 VHF 디바이스를 삭제합니다.

통사론

void VhfDelete(
  [in] VHFHANDLE VhfHandle,
  [in] BOOLEAN   Wait
);

매개 변수

[in] VhfHandle

VhfCreate대한 이전 호출에서 HID 원본 드라이버가 받은 가상 HID 디바이스에 대한 핸들입니다.

[in] Wait

디바이스를 삭제한 후 동기적으로 반환하려면 TRUE입니다. 이 경우 VHF(Virtual HID Framework)는 디바이스가 PnP Manager에 누락된 것으로 보고되고 EvtVhfCleanup 콜백 함수가 반환될 때까지 반환되지 않습니다.

FALSE는 예약되어 있으며 전달해서는 안 됩니다. 자세한 내용은 비고를 참조하세요.

반환 값

없음

발언

HID 원본 드라이버는 VhfDelete호출하기 직전에 VHF(Virtual HID Framework)에 대한 새 요청 시작을 중지해야 합니다.

VhfDelete 동기적으로 호출하려면 PASSIVE_LEVEL Wait 매개 변수를 TRUE로 설정하여 호출합니다. 이 경우 삭제를 완료한 후 동기적으로 반환됩니다. HID 소스 드라이버가 VHF에 EvtVhfCleanup 콜백 함수를 등록한 경우 VhfDelete 반환하기 전에 해당 콜백을 호출합니다. 함수는 동일한 스레드에서 호출될 수 있습니다.

VhfDelete 비동기적으로(Wait 매개 변수가 FALSE로 설정됨) 또는 PASSIVE_LEVEL보다 높은 IRQL에서 호출할 수 없습니다. 이렇게 하면 정의되지 않은 동작이 발생할 수 있습니다.

KMDF 드라이버가 이 함수를 호출해야 하는 시기에는 제한이 없습니다. VhfCreate 호출과 일치하는 함수에서 호출하는 것이 좋습니다. 예를 들어 VhfCreateEvtDriverDeviceAdd호출되는 경우 EvtDeviceCleanupCallback동기적으로 VhfDelete 호출합니다. VhfDelete 이전에 VhfStart호출하지 않고 VHFHANDLE에서 호출될 수 있습니다.

요구 사항

참고 항목

VHF(Virtual HID Framework) 사용하여 HID 원본 드라이버 작성