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 |