WDF_DPC_CONFIG-Struktur (wdfdpc.h)

Artikel
02/27/2024

[Gilt nur für KMDF]

Die WDF_DPC_CONFIG-Struktur enthält Konfigurationsinformationen für ein DPC-Objekt.

Syntax

typedef struct _WDF_DPC_CONFIG {
  ULONG       Size;
  PFN_WDF_DPC EvtDpcFunc;
  BOOLEAN     AutomaticSerialization;
} WDF_DPC_CONFIG, *PWDF_DPC_CONFIG;

Member

Size

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

EvtDpcFunc

Ein Zeiger auf die EvtDpcFunc-Rückruffunktion des Treibers.

AutomaticSerialization

Ein boolescher Wert, der bei TRUE angibt, dass das Framework die Ausführung der EvtDpcFunc-Rückruffunktion des DPC-Objekts mit Rückruffunktionen anderer Objekte synchronisiert, die sich unterhalb des übergeordneten DPC-Objekts befinden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

Die WDF_DPC_CONFIG-Struktur wird als Eingabe für WdfDpcCreate verwendet.

Um eine WDF_DPC_CONFIG-Struktur zu initialisieren, sollte Ihr Treiber zuerst WDF_DPC_CONFIG_INIT aufrufen und dann Strukturmember ausfüllen, die WDF_DPC_CONFIG_INIT nicht initialisiert.

Das Festlegen von AutomaticSerialization auf TRUE hat keine Auswirkung, wenn der Synchronisierungsbereich des übergeordneten Geräteobjekts auf WdfSynchronizationScopeNone festgelegt ist.

Wenn Sie AutomaticSerialization auf TRUE festlegen, schlägt WdfDpcCreate fehl, wenn die Ausführungsebene des übergeordneten Geräteobjekts auf WdfExecutionLevelPassive festgelegt ist.

Weitere Informationen zur AutomaticSerialisierung und zur Synchronisierung von Treiberrückruffunktionen finden Sie unter Synchronisierungstechniken für Framework-Based-Treiber.

Weitere Informationen zur Behandlung von Interrupts in frameworkbasierten Treibern finden Sie unter Behandeln von Hardwareunterbrechungen.