структура 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 . Платформа выделяет место для этой структуры при создании объекта . Если элемент ContextSizeOverride структуры WDF_OBJECT_ATTRIBUTES является ненулевым, его значение переопределяет значение в элементе ContextSize .

UniqueType

Для внутреннего использования.

EvtDriverGetUniqueContextType

Для внутреннего использования.

Комментарии

Для каждого экземпляра объекта платформа выделяет контекстную память с размером, основанным на значении члена ContextSize или значении элемента ContextSizeOverride структуры WDF_OBJECT_ATTRIBUTES .

Чтобы создать и инициализировать структуру 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