다음을 통해 공유


EVT_WDF_DEVICE_QUERY_REMOVE 콜백 함수(wdfdevice.h)

[KMDF 및 UMDF에 적용]

드라이버의 EvtDeviceQueryRemove 이벤트 콜백 함수는 지정된 디바이스를 중지하고 제거할 수 있는지 여부를 결정합니다.

구문

EVT_WDF_DEVICE_QUERY_REMOVE EvtWdfDeviceQueryRemove;

NTSTATUS EvtWdfDeviceQueryRemove(
  [in] WDFDEVICE Device
)
{...}

매개 변수

[in] Device

프레임워크 디바이스 개체에 대한 핸들입니다.

반환 값

드라이버가 디바이스를 중지하고 제거할 수 있다고 판단하는 경우 EvtDeviceQueryRemove 콜백 함수는 STATUS_SUCCESS 또는 NT_SUCCESS(상태)가 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 NT_SUCCESS(상태)가 FALSE와 같은 상태 값을 반환해야 합니다. STATUS_NOT_SUPPORTED 반환하지 마세요.

설명

EvtDeviceQueryRemove 콜백 함수를 등록하려면 드라이버가 WdfDeviceInitSetPnpPowerEventCallbacks를 호출해야 합니다.

디바이스와 드라이버가 유휴 전원 다운을 지원하는 경우 프레임워크가 드라이버의 EvtDeviceQueryRemove 콜백 함수를 호출할 때 디바이스가 작동 상태가 아닐 수 있습니다. 콜백 함수는 WdfDeviceStopIdle 을 호출하여 디바이스를 작동(D0) 상태로 전환한 다음 콜백 함수가 반환되기 전에 WdfDeviceResumeIdle 을 호출할 수 있습니다.

EvtDeviceQueryRemove 콜백 함수에 대한 자세한 내용은 디바이스 중지 요청 처리를 참조하세요.

프레임워크는 EvtDeviceQueryRemove 콜백 함수를 다른 PnP 및 전원 관리 콜백 함수와 동기화하지 않습니다. 프레임워크가 드라이버의 이벤트 콜백 함수 실행을 동기화하는 방법에 대한 자세한 내용은 자동 동기화 사용을 참조하세요.

요구 사항

요구 사항
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
최소 UMDF 버전 2.0
머리글 wdfdevice.h(Wdf.h 포함)
IRQL PASSIVE_LEVEL

추가 정보

EvtDeviceQueryStop