macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

Article
02/12/2024

[S’applique à KMDF et UMDF]

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE initialise la structure WDF_OBJECT_ATTRIBUTES d’un pilote et insère les informations de contexte définies par le pilote d’un objet dans la structure.

Syntaxe

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Paramètres

_Attributs
Pointeur vers une structure WDF_OBJECT_ATTRIBUTES .

_contexttype
Nom du type de structure d’une structure définie par le pilote qui décrit le contenu de l’espace de contexte d’un objet.

Valeur retournée

Cette macro ne retourne pas de valeur.

Remarques

Avant d’appeler WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE, vous devez appeler WDF_DECLARE_CONTEXT_TYPE ou WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globalement (pas dans une fonction).

La macro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE combine la fonction WDF_OBJECT_ATTRIBUTES_INIT et la macro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE .

Exemples

L’exemple de code suivant définit une structure de contexte WDM_NDIS_REQUEST. Ensuite, l’exemple appelle la macro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME pour inscrire la structure et spécifier que la méthode d’accesseur de contexte sera nommée RequestGetMyContext. Ensuite, dans une fonction, l’exemple alloue une structure WDF_OBJECT_ATTRIBUTES , puis initialise la structure 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 );