WdfDeviceSetDeviceState 関数 (wdfdevice.h)

[KMDF と UMDF に適用]

WdfDeviceSetDeviceState メソッドは、指定したデバイスのデバイスの状態を設定します。

構文

void WdfDeviceSetDeviceState(
  [in] WDFDEVICE         Device,
  [in] PWDF_DEVICE_STATE DeviceState
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] DeviceState

デバイスの状態情報を含むドライバーによって割り当てられた WDF_DEVICE_STATE 構造体へのポインター。

戻り値

なし

解説

ドライバーが無効なオブジェクト ハンドルを提供すると、バグ チェックが発生します。

ドライバーが WdfDeviceSetDeviceState を呼び出すと、フレームワークはデバイスの状態が変更されたことをプラグ アンド プレイ (PnP) マネージャーに通知します。

例

次のコード例では、指定したデバイスが無効になっていることを PnP マネージャーに通知します。

WDF_DEVICE_STATE    deviceState;

WDF_DEVICE_STATE_INIT (&deviceState);
deviceState.Disabled = WdfTrue;
WdfDeviceSetDeviceState (
                         Device,
                         &deviceState
                         );

要件

要件	値
対象プラットフォーム	ユニバーサル
最小 KMDF バージョン	1.0
最小 UMDF バージョン	2.0
Header	wdfdevice.h (Wdf.h を含む)
Library	Wdf01000.sys (KMDF);WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_DEVICE_STATE_INIT