KsQueueWorkItem-Funktion (ks.h)

Die KsQueueWorkItem-Funktion stellt das angegebene Arbeitselement mit einem Worker in die Warteschlange, der 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 das initialisierte Arbeitselement an, das in die Warteschlange eingereiht werden soll. Dieses Arbeitselement ist nur dem Worker zugeordnet, solange sich der Worker in einer Warteschlange befindet. Das Arbeitselement muss von IoAllocateWorkItem initialisiert worden sein.

Rückgabewert

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

Hinweise

Der Worker kann sich nur an einem Ort in einer Warteschlange befinden. Daher muss das nachfolgende Warteschlangen des Workers warten, bis das Arbeitselement mit der Ausführung begonnen hat. Diese Funktion kann bei DISPATCH_LEVEL aufgerufen werden.

Anforderungen