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 宏。

有关使用这些宏的详细信息，请参阅 框架对象上下文空间。

要求

要求 值
最低 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