WDF_WORKITEM_CONFIG-Struktur (wdfworkitem.h)

[Gilt für KMDF und UMDF]

Die WDF_WORKITEM_CONFIG-Struktur enthält Informationen, die einem Arbeitselement zugeordnet sind.

Syntax

typedef struct _WDF_WORKITEM_CONFIG {
  ULONG            Size;
  PFN_WDF_WORKITEM EvtWorkItemFunc;
  BOOLEAN          AutomaticSerialization;
} WDF_WORKITEM_CONFIG, *PWDF_WORKITEM_CONFIG;

Member

Size

Die Größe dieser WDF_WORKITEM_CONFIG-Struktur in Bytes.

EvtWorkItemFunc

Die Adresse einer EvtWorkItem-Ereignisrückruffunktion .

AutomaticSerialization

Ein boolescher Wert, der bei TRUE angibt, dass das Framework die Ausführung der EvtWorkItem-Rückruffunktion mit Rückruffunktionen von anderen Objekten synchronisiert, die sich unterhalb des übergeordneten Objekts des Arbeitselementobjekts befinden. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise". Bei FALSE synchronisiert das Framework die Ausführung der EvtWorkItem-Rückruffunktion nicht.

Hinweise

Ihr Treiber muss die WDF_WORKITEM_CONFIG-Struktur initialisieren, indem WDF_WORKITEM_CONFIG_INIT aufgerufen wird. Der Treiber kann die Struktur dann als Eingabeparameter an die WdfWorkItemCreate-Methode übergeben.

Das Festlegen des AutomaticSerialization-Elements von WDF_WORKITEM_CONFIG auf TRUE hat keine Auswirkung, wenn der Synchronisierungsbereich des übergeordneten Objekts auf WdfSynchronizationScopeNone festgelegt ist.

Wenn AutomaticSerializationTRUE ist, muss die Ausführungsebene des übergeordneten Objekts WdfExecutionLevelPassive sein.

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

Anforderungen

Anforderung	Wert
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfworkitem.h (include Wdf.h)

Weitere Informationen

EvtWorkItem

WDF_WORKITEM_CONFIG_INIT

WdfWorkItemCreate