estrutura WDF_OBJECT_CONTEXT_TYPE_INFO (wdfobject.h)

Artigo
03/01/2024

[Aplica-se a KMDF e UMDF]

A estrutura WDF_OBJECT_CONTEXT_TYPE_INFO descreve a memória de contexto definida pelo driver de um objeto de estrutura.

Sintaxe

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;

Membros

Size

O tamanho, em bytes, dessa estrutura.

ContextName

Uma cadeia de caracteres entre aspas que representa o nome de uma estrutura definida pelo driver que contém as informações de contexto de um objeto.

ContextSize

O tamanho, em bytes, da estrutura especificada pelo membro ContextName . A estrutura aloca espaço para essa estrutura quando cria um objeto . Se o membro ContextSizeOverride da estrutura WDF_OBJECT_ATTRIBUTES for diferente de zero, seu valor substituirá o valor no membro ContextSize .

UniqueType

Para uso interno.

EvtDriverGetUniqueContextType

Para uso interno.

Comentários

Para cada instância de objeto, a estrutura aloca memória de contexto com um tamanho baseado no valor do membro ContextSize ou no valor do membro ContextSizeOverride da estrutura WDF_OBJECT_ATTRIBUTES .

Para criar e inicializar uma estrutura de WDF_OBJECT_CONTEXT_TYPE_INFO, os drivers devem usar a macro WDF_DECLARE_CONTEXT_TYPE ou a macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME .

Para inserir um ponteiro para essa estrutura em uma estrutura WDF_OBJECT_ATTRIBUTES, os drivers devem usar a macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Para obter mais informações sobre como usar essas macros, consulte Espaço de Contexto do Objeto framework.