KsRegisterWorker-Funktion (ks.h)

Die KsRegisterWorker-Funktion verarbeitet Clients, die sich für die Verwendung eines Threads registrieren. Die Funktion kann einen neuen Thread mit der angegebenen Priorität erstellen, wenn derzeit keine freien Threads verfügbar sind. Dies muss von einem entsprechenden KsUnregisterWorker abgeglichen werden, wenn die Threadverwendung abgeschlossen ist. Die Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.

typedef PVOID PKSWORKER;

Die Workerroutinen funktionieren für undurchsichtige PKSWORKER-Objekte, die für jedes Arbeitselement erstellt werden, das gleichzeitig in die Warteschlange gestellt wird.

Syntax

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

Parameter

[in] WorkQueueType

Gibt die Priorität des zu erstellenden Threads an. Dies ist in der Regel entweder CriticalWorkQueue, DelayedWorkQueue oder HyperCriticalWorkQueue.

[out] Worker

Speicherort zum Platzieren des undurchsichtigen Kontexts, der beim Planen eines Arbeitselements verwendet werden muss. Dieser enthält den Warteschlangentyp und wird verwendet, um den Abschluss von Arbeitselementen zu synchronisieren.

Rückgabewert

Die KsRegisterWorker-Funktion gibt STATUS_SUCCESS zurück, wenn ein Worker initialisiert wurde oder wenn die Funktion nicht erfolgreich ist, einen Thread- oder Parameterfehler zurückgibt.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ks.h (ks.h einschließen)
Bibliothek	Ks.lib