Funzione KsRegisterWorker (ks.h)

La funzione KsRegisterWorker gestisce la registrazione dei client per l'uso di un thread. La funzione può creare un nuovo thread della priorità specificata se attualmente non sono disponibili thread gratuiti. Questa corrispondenza deve essere eseguita da un KsUnregisterWorker corrispondente al completamento dell'uso del thread. La funzione può essere chiamata solo in PASSIVE_LEVEL.

typedef PVOID PKSWORKER;

Le routine di lavoro funzionano su oggetti PKSWORKER opachi creati per ogni elemento di lavoro accodato contemporaneamente.

Sintassi

KSDDKAPI NTSTATUS KsRegisterWorker(
  [in]  WORK_QUEUE_TYPE WorkQueueType,
  [out] PKSWORKER       *Worker
);

Parametri

[in] WorkQueueType

Specifica la priorità del thread da creare. Si tratta in genere di CriticalWorkQueue, DelayedWorkQueue o HyperCriticalWorkQueue.

[out] Worker

Posizione in cui inserire il contesto opaco che deve essere utilizzato durante la pianificazione di un elemento di lavoro. Contiene il tipo di coda e viene usato per sincronizzare il completamento degli elementi di lavoro.

Valore restituito

La funzione KsRegisterWorker restituisce STATUS_SUCCESS se un ruolo di lavoro è stato inizializzato o se la funzione ha esito negativo restituisce un errore di thread o parametro.

Requisiti

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