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 |