WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE makro

Artikel
03/22/2025

[Gäller för KMDF och UMDF]

Makrot WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE initierar en drivrutins WDF_OBJECT_ATTRIBUTES struktur och infogar ett objekts drivrutinsdefinierade kontextinformation i strukturen.

Syntax

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parameterar

_attributes
En pekare till en WDF_OBJECT_ATTRIBUTES struktur.

_contexttype
Namnet på strukturtypen för en drivrutinsdefinierad struktur som beskriver innehållet i ett objekts kontextutrymme.

Returvärde

Det här makrot returnerar inte något värde.

Anmärkningar

Innan du anropar WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPEmåste du anropa WDF_DECLARE_CONTEXT_TYPE eller WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globalt (inte i en funktion).

Makrot WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE kombinerar funktionen WDF_OBJECT_ATTRIBUTES_INIT och WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE makro.

Exempel

I följande kodexempel definieras en WDM_NDIS_REQUEST kontextstruktur. Sedan anropar exemplet det WDF_DECLARE_CONTEXT_TYPE_WITH_NAME makrot för att registrera strukturen och anger att kontextåtkomstmetoden ska namnges RequestGetMyContext. I en funktion allokerar exemplet sedan en WDF_OBJECT_ATTRIBUTES struktur och initierar sedan den WDF_OBJECT_ATTRIBUTES strukturen.

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 );