피드백

VhfDelete 함수(vhf.h)

  • 아티클
  • 읽는 데 2분 걸림

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

구문

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

매개 변수

[in] VhfHandle

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

[in] Wait

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

비동기적으로 반환하려면 FALSE입니다. 자세한 내용은 설명 부분을 참조하십시오.

반환 값

없음

설명

HID 원본 드라이버는 VhfDelete를 호출하기 직전에 VHF(Virtual HID Framework)에 대한 새 요청 시작을 중지해야 합니다. VhfDelete 는 동기적으로 또는 비동기적으로 호출할 수 있습니다.

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

VhfDelete를 비동기적으로 호출하려면 최대 DISPATCH_LEVEL 호출합니다. DISPATCH_LEVEL 호출하는 경우 Wait 매개 변수를 FALSE로 설정해야 하며 함수가 즉시 반환됩니다. VHF는 삭제가 완료된 후 나중에 EvtVhfCleanup 콜백을 호출합니다.

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

요구 사항

   
대상 플랫폼 Windows
헤더 vhf.h
라이브러리 VhfKm.lib
IRQL Wait가 TRUE이면 PASSIVE_LEVEL; Wait가 FALSE이면 <= DISPATCH_LEVEL

참고 항목

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