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を返す必要があります。 それ以外の場合は、FALSE と評価NT_SUCCESS NTSTATUS 値を返す必要があります。
このコールバック関数の戻り値の詳細については、「 デバイスエラーの報告」を参照してください。
注釈
フレームワーク ベースのバス ドライバーは、 EvtDeviceSetLock コールバック関数を提供できます。 このコールバック関数を登録するために、バス ドライバーは WdfPdoInitSetEventCallbacks を呼び出します。
PnP マネージャーが、列挙された子デバイスの 1 つをロックまたはロック解除するようにバス ドライバーに要求すると、フレームワークはドライバーの EvtDeviceSetLock コールバック関数を呼び出します。
デバイスに EvtDeviceSetLock コールバック関数を実装しないのは、 FALSE として評価される NTSTATUS 値を返すのと同じです。
戻り値の詳細については、「 取り出し可能なデバイスのサポート」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | ユニバーサル |
最小 KMDF バージョン | 1.0 |
Header | wdfpdo.h (Wdf.h を含む) |
IRQL | PASSIVE_LEVEL |