Funzione KsQueueWorkItem (ks.h)

La funzione KsQueueWorkItem accoda l'elemento di lavoro specificato con un ruolo di lavoro precedente 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 in coda. 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.

Commenti

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'avvio dell'esecuzione dell'elemento di lavoro. Questa funzione può essere chiamata in DISPATCH_LEVEL.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Intestazione	ks.h (include Ks.h)
Libreria	Ks.lib