EVT_WDF_DEVICE_EJECT 콜백 함수(wdfpdo.h)
[KMDF에만 적용]
드라이버의 EvtDeviceEject 이벤트 콜백 함수는 도킹 스테이션에서 디바이스를 꺼내는 데 필요한 작업을 처리합니다.
구문론
EVT_WDF_DEVICE_EJECT EvtWdfDeviceEject;
NTSTATUS EvtWdfDeviceEject(
[in] WDFDEVICE Device
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
반환 값
작업이 성공하면 드라이버는 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 NT_SUCCESSFALSE계산되는 NTSTATUS 값을 반환해야 합니다. STATUS_NOT_SUPPORTED 반환하지 마세요.
반환 값에 대한 자세한 내용은 보고 디바이스 오류참조하세요.
비고
프레임워크 기반 버스 드라이버는 EvtDeviceEject 콜백 함수를 제공할 수 있습니다. 드라이버가 디바이스의 도킹 스테이션에서 열거된 자식 디바이스 중 하나를 물리적으로 배출하는 작업을 수행해야 하는 경우 버스 드라이버는 EvtDeviceEject 콜백 함수를 제공해야 합니다. 이 콜백 함수를 등록하려면 버스 드라이버가 WdfPdoInitSetEventCallbacks호출해야 합니다.
EvtDeviceEject 콜백 함수를 호출하기 전에 프레임워크는 드라이버의 EvtDeviceD0Exit 호출하고 콜백 함수를 EvtDeviceReleaseHardware를.
드라이버의 EvtDeviceEject 콜백 함수가 STATUS_SUCCESS 반환하는 경우 프레임워크는 드라이버의 자식 목록을 업데이트하여 배출된 디바이스를 더 이상 사용할 수 없음을 나타냅니다. 따라서 드라이버는 WdfPdoMarkMissing 또는 WdfChildListUpdateChildDescriptionAsMissing 호출할 필요가 없습니다.
디바이스 배출에 대한 자세한 내용은 ejectable Devices지원합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.0 |
| 헤더 | wdfpdo.h(Wdf.h 포함) |
| IRQL | PASSIVE_LEVEL |