EVT_WDF_IO_TARGET_QUERY_REMOVE 콜백 함수(wdfiotarget.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

드라이버의 EvtIoTargetQueryRemove 이벤트 콜백 함수는 프레임워크가 지정된 원격 I/O 대상의 디바이스를 안전하게 제거할 수 있는지 여부를 나타냅니다.

구문

EVT_WDF_IO_TARGET_QUERY_REMOVE EvtWdfIoTargetQueryRemove;

NTSTATUS EvtWdfIoTargetQueryRemove(
  [in] WDFIOTARGET IoTarget
)
{...}

매개 변수

[in] IoTarget

I/O 대상 개체에 대한 핸들입니다.

반환 값

드라이버가 프레임워크가 지정된 I/O 대상의 디바이스를 안전하게 제거할 수 있다고 판단하는 경우EvtIoTargetQueryRemove 콜백 함수는 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 이 콜백 함수는 STATUS_UNSUCCESSFUL 반환해야 합니다.

설명

드라이버의 EvtIoTargetQueryRemove 콜백 함수가 STATUS_SUCCESS 반환하는 경우 다른 드라이버가 STATUS_UNSUCCESSFUL 반환하지 않는 한 시스템에서 I/O 대상의 디바이스를 제거할 수 있습니다.

EvtIoTargetQueryRemove 콜백 함수를 등록하려면 콜백 함수의 주소를 I/O 대상의 WDF_IO_TARGET_OPEN_PARAMS 구조에 배치합니다. EvtIoTargetQueryRemove 콜백 함수는 선택 사항입니다. 이 콜백 함수를 제공하지 않는 것은 STATUS_SUCCESS 반환하는 것과 같습니다.

드라이버가 PnP 관리자가 대상 디바이스를 안전하게 제거할 수 있다고 판단하는 경우 EvtIoTargetQueryRemove 콜백 함수는 WdfIoTargetCloseForQueryRemove를 호출해야 합니다.

콜백 함수는 I/O 대상에 추가 I/O 요청을 보내는 드라이버의 기능을 사용하지 않도록 설정해야 합니다.

EvtIoTargetQueryRemove 콜백 함수에 대한 자세한 내용은 일반 I/O 대상의 상태 제어를 참조하세요.