EVT_WDF_IO_TARGET_REMOVE_CANCELED 콜백 함수(wdfiotarget.h)

아티클
08/08/2023

[KMDF 및 UMDF에 적용]

드라이버의 EvtIoTargetRemoveCanceled 이벤트 콜백 함수는 지정된 원격 I/O 대상 제거가 취소될 때 작업을 수행합니다.

구문

EVT_WDF_IO_TARGET_REMOVE_CANCELED EvtWdfIoTargetRemoveCanceled;

void EvtWdfIoTargetRemoveCanceled(
  [in] WDFIOTARGET IoTarget
)
{...}

매개 변수

[in] IoTarget

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

반환 값

없음

설명

EvtIoTargetRemoveCanceled 콜백 함수를 등록하려면 콜백 함수의 주소를 I/O 대상의 WDF_IO_TARGET_OPEN_PARAMS 구조에 배치합니다.

드라이버의 EvtIoTargetQueryRemove 콜백 함수인 WdfIoTargetCloseForQueryRemove인 경우 드라이버의 EvtIoTargetRemoveCanceled 콜백 함수는 WdfIoTargetOpen 을 호출하여 I/O 대상에 대한 I/O 요청 전송을 다시 사용하도록 설정해야 합니다. 드라이버가 WdfIoTargetOpen을 호출할 때 WDF_IO_TARGET_OPEN_PARAMS 구조체의 Type 멤버에 대해 WdfIoTargetOpenReopen을 지정할 수 있습니다.

드라이버가 EvtIoTargetQueryRemove 콜백 함수를 제공하지 않은 경우 드라이버의 EvtIoTargetRemoveCanceled 콜백 함수는 필요에 따라 WdfIoTargetOpen 을 호출하고 WdfIoTargetOpenReopen을 지정할 수 있습니다.

선택적 EvtIoTargetRemoveCanceled 콜백 함수는 드라이버가 I/O 대상에 대한 I/O 요청 전송을 다시 시작하기 전에 필요할 수 있는 추가 작업을 수행해야 합니다.

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