WORK_QUEUE_ITEM-Struktur (wdm.h)

Artikel
02/27/2024

Die WORK_QUEUE_ITEM-Struktur wird verwendet, um Arbeitselemente in einer Systemarbeitswarteschlange zu posten.

Warnung

Verwenden Sie diese Struktur mit äußerster Vorsicht. Weitere Informationen finden Sie im abschnitt "Hinweise" .

Syntax

typedef struct _WORK_QUEUE_ITEM {
  LIST_ENTRY             List;
  PWORKER_THREAD_ROUTINE WorkerRoutine;
  __volatile PVOID       Parameter;
} WORK_QUEUE_ITEM, *PWORK_QUEUE_ITEM;

Member

List

Doppelt verknüpfte Listenstruktur. Diese Struktur wird verwendet, um das Arbeitselement der Systemarbeitswarteschlange hinzuzufügen.

WorkerRoutine

Zeiger auf eine Rückrufroutine, die dieses Arbeitselement verarbeitet, wenn das Arbeitselement entfernt wird. Diese Rückrufroutine wird wie folgt deklariert:

VOID
(*PWORKER_THREAD_ROUTINE)(
    IN PVOID Parameter
    );

Parameter

Kontextinformationszeiger, der im Parameter-Element angegeben ist.

Parameter

Zeiger auf Kontextinformationen, die an die Rückrufroutine übergeben werden sollen, die im WorkerRoutine-Member angegeben ist.

Hinweise

Um eine WORK_QUEUE_ITEM-Struktur zu initialisieren, rufen Sie ExInitializeWorkItem auf.

Rufen Sie ExQueueWorkItem auf, um das initialisierte Arbeitselement in einer Systemarbeitswarteschlange zu posten.

ExInitializeWorkItem und ExQueueWorkItem können nur in Fällen verwendet werden, in denen das angegebene Arbeitselement keinem Geräteobjekt oder Gerätestapel zugeordnet ist. In allen anderen Fällen sollten Treiber IoAllocateWorkItem, IoFreeWorkItem und IoQueueWorkItem verwenden, da nur diese Routinen sicherstellen, dass das dem angegebenen Arbeitselement zugeordnete Geräteobjekt verfügbar bleibt, bis das Arbeitselement verarbeitet wurde.