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 값을 반환하는 것과 같습니다.