KsQueueWorkItem-Funktion (ks.h)

Die KsQueueWorkItem--Funktion stellt die angegebene Arbeitsaufgabe in die Warteschlange ein, die zuvor von der KsRegisterWorker Funktion erstellt wurde.

Syntax

KSDDKAPI NTSTATUS KsQueueWorkItem(
  [in] PKSWORKER        Worker,
  [in] PWORK_QUEUE_ITEM WorkItem
);

Parameter

[in] Worker

Gibt den zuvor zugewiesenen Worker an.

[in] WorkItem

Gibt die initialisierte Arbeitsaufgabe an, die in die Warteschlange gestellt werden soll. Diese Arbeitsaufgabe ist nur dem Worker zugeordnet, solange sich der Worker in einer Warteschlange befindet. Die Arbeitsaufgabe muss von IoAllocateWorkItem-initialisiert worden sein.

Rückgabewert

Die KsQueueWorkItem--Funktion gibt STATUS_SUCCESS zurück, wenn die Arbeitsaufgabe in die Warteschlange gestellt wurde, oder wenn die Funktion nicht erfolgreich war, wenn versucht wird, einen neuen Worker zu erstellen, wenn derzeit keine Threads verfügbar sind.

Bemerkungen

Der Worker kann sich nur an einer Warteschlange an einem Ort befinden, daher muss die nachfolgende Warteschlange des Workers warten, bis die Arbeitsaufgabe mit der Ausführung begonnen hat. Diese Funktion kann bei DISPATCH_LEVELaufgerufen werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib