WDF_DRIVER_CONFIG-Struktur (wdfdriver.h)

Artikel
02/29/2024

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

Member

Size

Die Größe (in Bytes) dieser Struktur.

EvtDriverDeviceAdd

Ein Zeiger auf die EvtDriverDeviceAdd-Rückruffunktion eines Treibers.

EvtDriverUnload

Ein Zeiger auf die EvtDriverUnload-Rückruffunktion eines Treibers.

DriverInitFlags

Ein bitweises OR mit einem oder mehreren WDF_DRIVER_INIT_FLAGS typisierten Werten, die Treiberinitialisierungsflags identifizieren.

DriverPoolTag

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

Hinweise

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

Wenn DriverPoolTag null ist, erstellt das Framework mithilfe der ersten vier Zeichen des Kernelmodusdienstnamens Ihres Treibers ein Standardpooltag. Wenn der Dienstname mit "WDF" beginnt (der Name beachtet die Groß-/Kleinschreibung nicht und enthält keine Anführungszeichen), 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_INIT aufrufen.