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 |