macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

[Si applica a KMDF e UMDF]

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE inizializza la struttura WDF_OBJECT_ATTRIBUTES di un driver e inserisce le informazioni sul contesto definito dal driver di un oggetto nella struttura.

Sintassi

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parametri

_Attributi
Puntatore a una struttura WDF_OBJECT_ATTRIBUTES .

_Contexttype
Nome del tipo di struttura di una struttura definita dal driver che descrive il contenuto dello spazio di contesto di un oggetto.

Valore restituito

Questa macro non restituisce un valore.

Commenti

Prima di chiamare WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE, è necessario chiamare WDF_DECLARE_CONTEXT_TYPE o WDF_DECLARE_CONTEXT_TYPE_WITH_NAME a livello globale (non all'interno di una funzione).

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE combina la funzione WDF_OBJECT_ATTRIBUTES_INIT e la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Esempio

Nell'esempio di codice seguente viene definita una struttura di contesto WDM_NDIS_REQUEST. Nell'esempio viene quindi richiamata la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME per registrare la struttura e specificare che il metodo della funzione di accesso al contesto verrà denominato RequestGetMyContext. In una funzione l'esempio alloca quindi una struttura WDF_OBJECT_ATTRIBUTES e quindi inizializza la struttura 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 );

Requisiti

Piattaforma di destinazione

Universale

Versione KMDF minima

1.0

Versione UMDF minima

2,0

Intestazione

Wdfobject.h (include Wdf.h)

Vedi anche

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE