WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE macro

Artigo
03/22/2025

[Aplica-se a KMDF e UMDF]

A macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE inicializa a estrutura de WDF_OBJECT_ATTRIBUTES de um driver e insere as informações de contexto definidas pelo driver de um objeto na estrutura.

Sintaxe

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parâmetros

_attributes
Um ponteiro para uma estrutura WDF_OBJECT_ATTRIBUTES.

_contexttype
O nome do tipo de estrutura de uma estrutura definida pelo driver que descreve o conteúdo do espaço de contexto de um objeto.

Valor de retorno

Essa macro não retorna um valor.

Observações

Antes de chamar WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE, você deve chamar WDF_DECLARE_CONTEXT_TYPE ou WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globalmente (não dentro de uma função).

A macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE combina a função WDF_OBJECT_ATTRIBUTES_INIT e a macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE.

Exemplos

O exemplo de código a seguir define uma estrutura de contexto WDM_NDIS_REQUEST. Em seguida, o exemplo invoca a macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME para registrar a estrutura e especificar que o método de acessador de contexto será nomeado RequestGetMyContext. Em seguida, em uma função, o exemplo aloca uma estrutura WDF_OBJECT_ATTRIBUTES e, em seguida, inicializa a estrutura 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 );