WDF_DRIVER_CONFIG Struktur (wdfdriver.h)

[Gilt für KMDF und UMDF]

Die WDF_DRIVER_CONFIG-Struktur ist ein Eingabeparameter für WdfDriverCreate.

Syntax

typedef struct _WDF_DRIVER_CONFIG {
  ULONG                     Size;
  PFN_WDF_DRIVER_DEVICE_ADD EvtDriverDeviceAdd;
  PFN_WDF_DRIVER_UNLOAD     EvtDriverUnload;
  ULONG                     DriverInitFlags;
  ULONG                     DriverPoolTag;
} WDF_DRIVER_CONFIG, *PWDF_DRIVER_CONFIG;

Elemente

Size

Die Größe dieser Struktur in Byte.

EvtDriverDeviceAdd

Ein Zeiger auf die EvtDriverDeviceAdd Rückruffunktion eines Treibers.

EvtDriverUnload

Ein Zeiger auf die EvtDriverUnload Rückruffunktion eines Treibers.

DriverInitFlags

Ein bitweises ODER von mindestens einem WDF_DRIVER_INIT_FLAGS-typierten Werten, die Treiberinitialisierungsflags identifizieren.

DriverPoolTag

(KMDF-Versionen 1.5 und höher.) Ein treiberdefiniertes Pooltag, das das Framework allen Poolzuweisungen des Treibers zuweist. Debugger zeigen dieses Tag an. Weitere Informationen zum Angeben eines Pooltags finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Ihr Treiber kann optional ein Pooltag angeben, das das Framework allen Poolzuweisungen des Treibers zuweist. Treiber geben in der Regel eine Zeichenfolge von bis zu vier Zeichen an, getrennt durch einfache Anführungszeichen, in umgekehrter Reihenfolge (z. B. "dcba"). Der ASCII-Wert jedes Zeichens im Tag muss zwischen 0 und 127 stehen.

Wenn DriverPoolTag null ist, erstellt das Framework ein Standardpooltag, indem die ersten vier Zeichen des Kernelmodusdienstnamens des Treibers verwendet werden. Wenn der Dienstname mit "WDF" beginnt (bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet und die Anführungszeichen nicht eingeschlossen), werden die nächsten vier Zeichen verwendet. Wenn weniger als vier Zeichen verfügbar sind, wird "FxDr" verwendet.

Um eine WDF_DRIVER_CONFIG-Struktur zu initialisieren, müssen Treiber WDF_DRIVER_CONFIG_INITaufrufen.

Anforderungen

Siehe auch

EvtDriverDeviceAdd

EvtDriverUnload-

WDF_DRIVER_CONFIG_INIT

WDF_DRIVER_INIT_FLAGS

WdfDriverCreate