KsUnregisterWorker-Funktion (ks.h)

Mit der KsUnregisterWorker-Funktion können Clients die Registrierung eines Workers aufheben. Die Funktion kann Threads zerstören, abhängig von der Anzahl der verwendeten Threads. Dies darf nur nach erfolgreicher Ausführung von KsRegisterWorker verwendet werden. Die Funktion kann nur bei PASSIVE_LEVEL aufgerufen werden.

Syntax

KSDDKAPI VOID KsUnregisterWorker(
  [in] PKSWORKER Worker
);

Parameter

[in] Worker

Gibt den zuvor zugewiesenen Worker an, der die Registrierung aufheben soll. Die Funktion wartet, bis ein ausstehendes Arbeitselement abgeschlossen ist.

Rückgabewert

Keine

Bemerkungen

Der Client muss sicherstellen, dass die ausstehenden E/A-Vorgänge, die für einen Workerthread initiiert wurden, abgeschlossen wurden, bevor die Registrierung des Workers aufgehoben wurde. Dies bedeutet, dass ausstehende E/A-Vorgänge abgebrochen oder abgeschlossen werden, bevor die Registrierung des Workers aufgehoben wird oder bevor das Workerelement zum letzten Mal von seinem Rückruf zurückgibt und die Registrierung aufgehoben wird. Durch das Aufheben der Registrierung eines Workers wird gewartet, bis alle aktuell in der Warteschlange befindlichen Arbeitselemente abgeschlossen sind, bevor sie zurückgegeben werden.

Anforderungen

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