WDF_OBJECT_CONTEXT_TYPE_INFO 結構 (wdfobject.h)

  • 發行項

[適用於 KMDF 和 UMDF]

WDF_OBJECT_CONTEXT_TYPE_INFO 結構描述架構物件的驅動程式定義內容記憶體。

語法

typedef struct _WDF_OBJECT_CONTEXT_TYPE_INFO {
  ULONG                          Size;
  LPCSTR                         ContextName;
  size_t                         ContextSize;
  PCWDF_OBJECT_CONTEXT_TYPE_INFO UniqueType;
  PFN_GET_UNIQUE_CONTEXT_TYPE    EvtDriverGetUniqueContextType;
} WDF_OBJECT_CONTEXT_TYPE_INFO, *PWDF_OBJECT_CONTEXT_TYPE_INFO;

成員

Size

這個結構的大小，以位元組為單位。

ContextName

引號字串，表示包含物件內容資訊的驅動程式定義結構名稱。

ContextSize

ContextName 成員所指定結構的大小，以位元組為單位。 架構會在建立物件時為這個結構配置空間。 如果WDF_OBJECT_ATTRIBUTES結構的 ContextSizeOverride 成員為非零，則其值會覆寫 ContextSize 成員中的值。

UniqueType

供內部使用。

EvtDriverGetUniqueContextType

供內部使用。

備註

針對每個物件實例，架構會以 ContextSize 成員的值或 WDF_OBJECT_ATTRIBUTES 結構之 ContextSizeOverride 成員的值為基礎，配置內容記憶體大小。

若要建立和初始化WDF_OBJECT_CONTEXT_TYPE_INFO結構，驅動程序應該使用 WDF_DECLARE_CONTEXT_TYPE 宏或 WDF_DECLARE_CONTEXT_TYPE_WITH_NAME 宏。

若要將此結構的指標插入WDF_OBJECT_ATTRIBUTES結構中，驅動程序應該使用 WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE 宏。

如需使用這些宏的詳細資訊，請參閱 Framework 對象內容空間。

規格需求

需求 值
最小 KMDF 版本 1.0
最低UMDF版本 2.0
標頭 wdfobject.h (包含 Wdf.h)

另請參閱

WDF_DECLARE_CONTEXT_TYPE

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE