macro de WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

Artículo
06/15/2023

[Se aplica a KMDF y UMDF]

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE inicializa la estructura WDF_OBJECT_ATTRIBUTES de un controlador e inserta la información de contexto definida por el controlador de un objeto en la estructura.

Sintaxis

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parámetros

_Atributos
Puntero a una estructura de WDF_OBJECT_ATTRIBUTES .

_contexttype
Nombre del tipo de estructura de una estructura definida por el controlador que describe el contenido del espacio de contexto de un objeto.

Valor devuelto

Esta macro no devuelve un valor.

Comentarios

Antes de llamar a WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE, debe llamar a WDF_DECLARE_CONTEXT_TYPE o WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globalmente (no dentro de una función).

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE combina la función WDF_OBJECT_ATTRIBUTES_INIT y la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Ejemplos

En el ejemplo de código siguiente se define una estructura de contexto WDM_NDIS_REQUEST. A continuación, en el ejemplo se invoca la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME para registrar la estructura y especificar que el método de descriptor de acceso de contexto se denominará RequestGetMyContext. A continuación, en una función, el ejemplo asigna una estructura de WDF_OBJECT_ATTRIBUTES y, a continuación, inicializa la estructura WDF_OBJECT_ATTRIBUTES .

typedef struct _WDM_NDIS_REQUEST
{
   PMP_ADAPTER  Adapter;
   NDIS_OID  Oid;
   NDIS_REQUEST_TYPE  RequestType;
   PVOID  InformationBuffer;
   ULONG  InformationBufferLength;
   PULONG  BytesReadOrWritten;
   PULONG  BytesNeeded;
} WDM_NDIS_REQUEST, *PWDM_NDIS_REQUEST;

WDF_DECLARE_CONTEXT_TYPE_WITH_NAME(WDM_NDIS_REQUEST, RequestGetMyContext);

// above are in global space

...

WDF_OBJECT_ATTRIBUTES  attributes;

WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE( &attributes, WDM_NDIS_REQUEST );