WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE makro

[Platí pro KMDF a UMDF]

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE inicializuje strukturu WDF_OBJECT_ATTRIBUTES ovladače a vloží do struktury informace o kontextu definovaném ovladačem objektu.

Syntaxe

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parametry

_attributes
Ukazatel na strukturu WDF_OBJECT_ATTRIBUTES.

_contexttype
Název typu struktury struktury definované ovladačem, která popisuje obsah kontextového prostoru objektu.

Návratová hodnota

Toto makro nevrací hodnotu.

Poznámky

Před voláním WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPEje nutné volat WDF_DECLARE_CONTEXT_TYPE nebo WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globálně (ne v rámci funkce).

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE kombinuje funkci WDF_OBJECT_ATTRIBUTES_INIT a makro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE.

Příklady

Následující příklad kódu definuje WDM_NDIS_REQUEST kontextovou strukturu. Pak příklad vyvolá WDF_DECLARE_CONTEXT_TYPE_WITH_NAME makro pro registraci struktury a určí, že metoda kontextového přístupového objektu bude pojmenována RequestGetMyContext. Potom ve funkci příklad přidělí WDF_OBJECT_ATTRIBUTES strukturu a pak inicializuje WDF_OBJECT_ATTRIBUTES strukturu.

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

Požadavky

Cílová platforma	univerzální
Minimální verze SLUŽBY KMDF	1.0
Minimální verze UMDF	2.0
Záhlaví	Wdfobject.h (včetně Wdf.h)

Viz také

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE