Funzione KsQueueWorkItem (ks.h)

La funzione KsQueueWorkItem accoda l'elemento di lavoro specificato con un ruolo di lavoro precedentemente creato dalla funzione KsRegisterWorker.

Sintassi

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

Parametri

[in] Worker

Specifica il ruolo di lavoro allocato in precedenza.

[in] WorkItem

Specifica l'elemento di lavoro inizializzato da accodare. Questo elemento di lavoro è associato solo al ruolo di lavoro, purché il ruolo di lavoro si trova in una coda. L'elemento di lavoro deve essere stato inizializzato da IoAllocateWorkItem.

Valore restituito

La funzione KsQueueWorkItem restituisce STATUS_SUCCESS se l'elemento di lavoro è stato accodato o se la funzione ha esito negativo restituisce un errore quando si tenta di creare un nuovo ruolo di lavoro se non sono attualmente disponibili thread.

Osservazioni

Il ruolo di lavoro può trovarsi solo in una coda in un'unica posizione, quindi l'accodamento successivo del ruolo di lavoro deve attendere fino all'inizio dell'esecuzione dell'elemento di lavoro. Questa funzione può essere chiamata in DISPATCH_LEVEL.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
libreria	Ks.lib