EVT_WDF_IO_TARGET_REMOVE_COMPLETE 콜백 함수(wdfiotarget.h)

아티클
02/27/2024

[KMDF 및 UMDF에 적용]

드라이버의 EvtIoTargetRemoveComplete 이벤트 콜백 함수는 지정된 원격 I/O 대상 제거가 완료되면 작업을 수행합니다.

구문

EVT_WDF_IO_TARGET_REMOVE_COMPLETE EvtWdfIoTargetRemoveComplete;

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

매개 변수

[in] IoTarget

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

반환 값

없음

설명

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

프레임워크는 드라이버의 EvtIoTargetQueryRemove 콜백 함수가 STATUS_SUCCESS 반환하거나 디바이스가 예기치 않게 제거된 후(서프라이즈 제거) 드라이버의 EvtIoTargetRemoveComplete 콜백 함수를 호출합니다.

드라이버의 EvtIoTargetRemoveComplete 콜백 함수는 WdfIoTargetClose를 호출하여 원격 I/O 대상을 영구적으로 닫아야 합니다. 대상 디바이스가 제거되었으므로 EvtIoTargetRemoveComplete 콜백 함수는 드라이버가 대상을 열 때 할당했을 수 있는 시스템 리소스를 해제하는 등 필요할 수 있는 추가 대상 제거 작업도 수행해야 합니다.

EvtIoTargetRemoveComplete 콜백 함수는 선택 사항입니다. 드라이버가 이 콜백 함수를 제공하지 않으면 프레임워크는 I/O 대상을 영구적으로 닫습니다.

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