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_SUCCESS 評估為 FALSE 的 NTSTATUS 值。

如需此回呼函式傳回值的詳細資訊，請參閱報告裝置失敗。

架構型總線驅動程式可以提供 EvtDeviceSetLock 回呼函式。若要註冊此回呼函式，總線驅動程式會呼叫 WdfPdoInitSetEventCallbacks。

當 PnP 管理員要求總線驅動程式鎖定或解除鎖定其中一個列舉的子裝置時，架構會呼叫驅動程式的 EvtDeviceSetLock 回呼函式。

未實作裝置的 EvtDeviceSetLock 回呼函式相當於傳回評估為 FALSE 的 NTSTATUS 值。

如需傳回值的詳細資訊，請參閱支援可退出的裝置。