次の方法で共有

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

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

注釈

構造体メンバーは、WDF_TRI_STATE 型を使用します。 WdfUseDefault 値は、フレームワークがスタック内の下位ドライバーによって提供された値を使用することを示します。 たとえば、バス ドライバーが NotDisableable の 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
ヘッダー wdfdevice.h (Wdf.h を含む)
  • Last updated on