EVT_WDF_DEVICE_SET_LOCK 콜백 함수(wdfpdo.h)
[KMDF에만 적용]
드라이버의 EvtDeviceSetLock 이벤트 콜백 함수는 지정된 디바이스를 배출할 수 없도록 잠기거나 디바이스를 해제하여 배출할 수 있도록 합니다.
구문
EVT_WDF_DEVICE_SET_LOCK EvtWdfDeviceSetLock;
NTSTATUS EvtWdfDeviceSetLock(
[in] WDFDEVICE Device,
[in] BOOLEAN IsLocked
)
{...}
매개 변수
[in] Device
프레임워크 디바이스 개체에 대한 핸들입니다.
[in] IsLocked
드라이버가 디바이스를 잠그거나 잠금 해제해야 하는지 여부를 나타내는 부울 값입니다. TRUE이면 드라이버가 디바이스를 잠가야 디바이스를 배출할 수 없습니다. FALSE이면 드라이버가 디바이스의 잠금을 해제하여 꺼내야 합니다.
반환 값
드라이버가 디바이스를 성공적으로 잠그거나 잠금을 해제하는 경우 STATUS_SUCCESS 반환해야 합니다. 그렇지 않으면 NT_SUCCESSFALSE로 평가되는 NTSTATUS 값을 반환해야 합니다.
이 콜백 함수의 반환 값에 대한 자세한 내용은 보고 디바이스 오류를 참조하세요.
설명
프레임워크 기반 버스 드라이버는 EvtDeviceSetLock 콜백 함수를 제공할 수 있습니다. 이 콜백 함수를 등록하기 위해 버스 드라이버는 WdfPdoInitSetEventCallbacks를 호출합니다.
프레임워크는 PnP 관리자가 버스 드라이버에 열거된 자식 디바이스 중 하나를 잠그거나 잠금 해제하도록 요청할 때 드라이버의 EvtDeviceSetLock 콜백 함수를 호출합니다.
디바이스에 대한 EvtDeviceSetLock 콜백 함수를 구현하지 않는 것은 FALSE로 평가되는 NTSTATUS 값을 반환하는 것과 같습니다.
반환 값에 대한 자세한 내용은 Ejectable 디바이스 지원을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.0 |
머리글 | wdfpdo.h(Wdf.h 포함) |
IRQL | PASSIVE_LEVEL |