WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE Makro

[Gilt für KMDF und UMDF]

Das WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE Makro initialisiert die WDF_OBJECT_ATTRIBUTES Struktur eines Treibers und fügt die vom Treiber definierten Kontextinformationen eines Objekts in die Struktur ein.

Syntax

void WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(
    _attributes,
    _contexttype
);

Die Parameter

_attributes
Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES Struktur.

_contexttype
Der Strukturtypname einer treiberdefinierten Struktur, die den Inhalt des Kontextbereichs eines Objekts beschreibt.

Rückgabewert

Dieses Makro gibt keinen Wert zurück.

Bemerkungen

Bevor Sie WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPEaufrufen, müssen Sie WDF_DECLARE_CONTEXT_TYPE oder WDF_DECLARE_CONTEXT_TYPE_WITH_NAME global aufrufen (nicht innerhalb einer Funktion).

Das WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE Makro kombiniert die WDF_OBJECT_ATTRIBUTES_INIT Funktion und das WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE Makro.

Beispiele

Im folgenden Codebeispiel wird eine WDM_NDIS_REQUEST Kontextstruktur definiert. Anschließend ruft das Beispiel das WDF_DECLARE_CONTEXT_TYPE_WITH_NAME Makro auf, um die Struktur zu registrieren und anzugeben, dass die Kontextaccessormethode RequestGetMyContext-benannt wird. Anschließend weist das Beispiel in einer Funktion eine WDF_OBJECT_ATTRIBUTES Struktur zu und initialisiert dann die WDF_OBJECT_ATTRIBUTES Struktur.

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

Anforderungen

Zielplattform	universelle
Minimale KMDF-Version	1.0
Minimale UMDF-Version	2.0
Kopfzeile	Wdfobject.h (enthalten Wdf.h)

Siehe auch

WDF_OBJECT_ATTRIBUTES

WDF_OBJECT_ATTRIBUTES_INIT

WDF_OBJECT_ATTRIBUTES_SET_CONTEXT_TYPE