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

WDF_TRI_STATE類型的值，如果設定為 WdfTrue，表示裝置已停用。 如需 WDF_TRI_STATE 類型的詳細資訊，請參閱下列一節。

DontDisplayInUI

WDF_TRI_STATE類型的值，如果設定為 WdfTrue，表示裝置在 裝置管理員 中未顯示) 隱藏 (。 如需詳細資訊，請參閱 檢視隱藏的裝置。 (將此成員設定為 WdfTrue 之後，變更其值不會有任何作用。)

Failed

WDF_TRI_STATE類型的值，如果設定為 WdfTrue，表示裝置存在但失敗。

NotDisableable

WDF_TRI_STATE型別值，如果設定為 WdfTrue，表示無法停用裝置。

Removed

WDF_TRI_STATE型別值，如果設定為 WdfTrue，表示裝置已移除。

ResourcesChanged

WDF_TRI_STATE類型的值，如果設定為 WdfTrue，表示裝置的資源需求已變更。

AssignedToGuest

WDF_TRI_STATE型別值，如果設定為 WdfTrue，表示裝置將本身回報為指派給客體磁碟分區。

備註

結構成員會使用 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)