EVT_WDF_DEVICE_EJECT 콜백 함수(wdfpdo.h)

  • 아티클

[KMDF에만 적용]

드라이버의 EvtDeviceEject 이벤트 콜백 함수는 도킹 스테이션에서 디바이스를 꺼내는 데 필요한 작업을 처리합니다.

구문

EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;

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

매개 변수

[in] Device

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

반환 값

작업이 성공하면 드라이버는 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 NT_SUCCESS FALSE로 평가되는 NTSTATUS 값을 반환 해야 합니다. STATUS_NOT_SUPPORTED 반환하지 마세요.

반환 값에 대한 자세한 내용은 디바이스 오류 보고를 참조하세요.

설명

프레임워크 기반 버스 드라이버는 EvtDeviceEject 콜백 함수를 제공할 수 있습니다. 드라이버가 디바이스의 도킹 스테이션에서 열거된 자식 디바이스 중 하나를 물리적으로 꺼내는 작업을 수행해야 하는 경우 버스 드라이버는 EvtDeviceEject 콜백 함수를 제공해야 합니다. 이 콜백 함수를 등록하려면 버스 드라이버가 WdfPdoInitSetEventCallbacks를 호출해야 합니다.

EvtDeviceEject 콜백 함수를 호출하기 전에 프레임워크는 드라이버의 EvtDeviceD0Exit 및 EvtDeviceReleaseHardware 콜백 함수를 호출합니다.

드라이버의 EvtDeviceEject 콜백 함수가 STATUS_SUCCESS 반환하는 경우 프레임워크는 드라이버의 자식 목록을 업데이트하여 꺼내는 디바이스를 더 이상 사용할 수 없음을 나타냅니다. 따라서 드라이버는 WdfPdoMarkMissing 또는 WdfChildListUpdateChildDescriptionAsMissing을 호출할 필요가 없습니다.

디바이스 배출에 대한 자세한 내용은 꺼내기 가능 디바이스 지원을 참조하세요.

요구 사항

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

추가 정보

EvtDeviceSetLock