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 |