[适用于 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) |