WDF_DEVICE_STATE 構造体 (wdfdevice.h)

  • [アーティクル]

[KMDF と UMDF に適用]

WDF_DEVICE_STATE構造体は、デバイスのプラグ アンド プレイ状態を指定します。

構文

typedef struct _WDF_DEVICE_STATE {
  ULONG         Size;
  WDF_TRI_STATE Disabled;
  WDF_TRI_STATE DontDisplayInUI;
  WDF_TRI_STATE Failed;
  WDF_TRI_STATE NotDisableable;
  WDF_TRI_STATE Removed;
  WDF_TRI_STATE ResourcesChanged;
  WDF_TRI_STATE AssignedToGuest;
} WDF_DEVICE_STATE, *PWDF_DEVICE_STATE;

メンバー

Size

この構造体のサイズ (バイト単位)。

Disabled

WdfTrue に設定されている場合、デバイスが無効であることを示す、WDF_TRI_STATE型指定された値。 WDF_TRI_STATEの種類の詳細については、次の「解説」セクションを参照してください。

DontDisplayInUI

WdfTrue に設定されている場合、WDF_TRI_STATE型指定された値は、デバイスがデバイス マネージャーで非表示 (表示されません) であることを示します。 詳細については、「 非表示デバイスの表示」を参照してください。 (このメンバーを WdfTrue に設定した後、その値を変更しても効果はありません)。

Failed

WdfTrue に設定されている場合、デバイスが存在するが失敗したことを示す、WDF_TRI_STATE型指定された値。

NotDisableable

WdfTrue に設定されている場合、デバイスを無効にできないことを示す、WDF_TRI_STATE型指定された値。

Removed

WdfTrue に設定されている場合、デバイスが削除されたことを示す、WDF_TRI_STATE型指定された値。

ResourcesChanged

WdfTrue に設定されている場合、デバイスのリソース要件が変更されたことを示す、WDF_TRI_STATE型指定された値。

AssignedToGuest

WdfTrue に設定されている場合、デバイスがゲスト パーティションに割り当てられていることを示す、WDF_TRI_STATE型指定された値。

注釈

構造体メンバーは 、WDF_TRI_STATE 型を使用します。 値 WdfUseDefault は、フレームワークがスタック内の下位ドライバーによって提供された値を使用することを示します。 たとえば、バス ドライバーが NotDisable に WdfTrue を指定し、デバイスの関数ドライバーが WdfUseDefault を指定している場合、フレームワークはデバイスの状態に WdfTrue を使用します。

WDF_DEVICE_STATE構造体は、WdfDeviceSetDeviceState および WdfDeviceGetDeviceState のパラメーターとして使用されます。

WDF_DEVICE_STATE構造体を初期化するには、ドライバーが WDF_DEVICE_STATE_INITを呼び出す必要があります。

WDF_DEVICE_STATE構造体のメンバーの詳細については、「PNP_DEVICE_STATE」を参照してください。

要件

要件 値
最小 KMDF バージョン 1.0
最小 UMDF バージョン 2.0
Header wdfdevice.h (Wdf.h を含む)