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) |