makro WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE

Artikel
02/08/2024

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

Parameter

_Attribute
Ein Zeiger auf eine WDF_OBJECT_ATTRIBUTES-Struktur .

_Contexttype
Der Strukturtypname einer vom Treiber definierten Struktur, die den Inhalt des Kontextraums eines Objekts beschreibt.

Rückgabewert

Dieses Makro gibt keinen Wert zurück.

Hinweise

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

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 makro WDF_DECLARE_CONTEXT_TYPE_WITH_NAME auf, um die Struktur zu registrieren und anzugeben, dass die Kontextzugriffsmethode den Namen RequestGetMyContext trägt. 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 );