Función KsRegisterWorker (ks.h)

La función KsRegisterWorker controla los clientes que se registran para su uso de un subproceso. La función puede crear un nuevo subproceso de la prioridad especificada si actualmente no hay ningún subproceso libre disponible. Debe coincidir con un KsUnregisterWorker correspondiente cuando se completa el uso de subprocesos. Solo se puede llamar a la función en PASSIVE_LEVEL.

typedef PVOID PKSWORKER;

Las rutinas de trabajo funcionan en objetos PKSWORKER opacos que se crean para cada elemento de trabajo en cola al mismo tiempo.

Sintaxis

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

Parámetros

[in] WorkQueueType

Especifica la prioridad del subproceso que se va a crear. Esto suele ser CriticalWorkQueue, DelayedWorkQueue o HyperCriticalWorkQueue.

[out] Worker

Ubicación para colocar el contexto opaco que se debe usar al programar un elemento de trabajo. Contiene el tipo de cola y se usa para sincronizar la finalización de los elementos de trabajo.

Valor devuelto

La función KsRegisterWorker devuelve STATUS_SUCCESS si se inicializó un trabajo o si no se realizó correctamente, la función devuelve un error de subproceso o parámetro.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib