makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

[Dotyczy usług KMDF i UMDF]

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE inicjuje strukturę WDF_OBJECT_ATTRIBUTES sterownika i wstawia do struktury informacje kontekstowe zdefiniowane przez sterownik obiektu.

Składnia

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Parametry

_attributes
Wskaźnik do struktury WDF_OBJECT_ATTRIBUTES.

_contexttype
Nazwa typu struktury struktury struktury zdefiniowanej przez sterownik, która opisuje zawartość przestrzeni kontekstowej obiektu.

Wartość zwracana

To makro nie zwraca wartości.

Uwagi

Przed wywołaniem WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPEnależy wywołać WDF_DECLARE_CONTEXT_TYPE lub WDF_DECLARE_CONTEXT_TYPE_WITH_NAME globalnie (nie w ramach funkcji).

Makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE łączy funkcję WDF_OBJECT_ATTRIBUTES_INIT i makro WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE.

Przykłady

Poniższy przykład kodu definiuje strukturę kontekstu WDM_NDIS_REQUEST. Następnie przykład wywołuje makro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME, aby zarejestrować strukturę i określić, że metoda dostępu kontekstu będzie mieć nazwę RequestGetMyContext. Następnie w funkcji przykład przydziela strukturę WDF_OBJECT_ATTRIBUTES, a następnie inicjuje strukturę 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 );

Wymagania

Zobacz też

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE