VhfDelete 함수(vhf.h)

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

구문

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

매개 변수

[in] VhfHandle

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

[in] Wait

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

FALSE는 예약되어 있으며 전달해서는 안 됩니다. 자세한 내용은 설명 부분을 참조하십시오.

반환 값

없음

설명

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

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

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

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

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	vhf.h
라이브러리	VhfKm.lib
IRQL	대기는 TRUE입니다. PASSIVE_LEVEL

추가 정보

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