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