EVT_WDF_DEVICE_QUERY_STOP 콜백 함수(wdfdevice.h)

  • 아티클

[KMDF 및 UMDF에 적용]

드라이버의 EvtDeviceQueryStop 이벤트 콜백 함수는 PnP 관리자가 시스템 하드웨어 리소스를 재배포할 수 있도록 지정된 디바이스를 중지할 수 있는지 여부를 결정합니다.

구문

EVT_WDF_DEVICE_QUERY_STOP EvtWdfDeviceQueryStop;

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

매개 변수

[in] Device

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

반환 값

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

설명

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

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

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

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

요구 사항

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

추가 정보

EvtDeviceQueryRemove