estructura WDF_OBJECT_CONTEXT_TYPE_INFO (wdfobject.h)

Artículo
03/05/2024

[Se aplica a KMDF y UMDF]

La estructura WDF_OBJECT_CONTEXT_TYPE_INFO describe la memoria de contexto definida por el controlador de un objeto de marco.

Sintaxis

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;

Miembros

Size

Tamaño, en bytes, de esta estructura.

ContextName

Cadena entre comillas que representa el nombre de una estructura definida por el controlador que contiene la información de contexto de un objeto.

ContextSize

Tamaño, en bytes, de la estructura que especifica el miembro ContextName . El marco asigna espacio para esta estructura cuando crea un objeto . Si el miembro ContextSizeOverride de la estructura WDF_OBJECT_ATTRIBUTES es distinto de cero, su valor invalida el valor en el miembro ContextSize .

UniqueType

Para uso interno.

EvtDriverGetUniqueContextType

Para uso interno.

Observaciones

Para cada instancia de objeto, el marco asigna memoria de contexto con un tamaño basado en el valor del miembro ContextSize o el valor del miembro ContextSizeOverride de la estructura WDF_OBJECT_ATTRIBUTES .

Para crear e inicializar una estructura de WDF_OBJECT_CONTEXT_TYPE_INFO, los controladores deben usar la macro WDF_DECLARE_CONTEXT_TYPE o la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME .

Para insertar un puntero a esta estructura en una estructura WDF_OBJECT_ATTRIBUTES, los controladores deben usar la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Para obtener más información sobre el uso de estas macros, vea Espacio de contexto de objetos de marco.