ConvertThreadToFiber-Funktion (winbase.h)

Artikel
03/03/2024

Konvertiert den aktuellen Thread in eine Faser. Sie müssen einen Thread in eine Faser konvertieren, bevor Sie andere Fasern planen können.

Syntax

LPVOID ConvertThreadToFiber(
  [in, optional] LPVOID lpParameter
);

Parameter

[in, optional] lpParameter

Ein Zeiger auf eine Variable, die an die Faser übergeben wird. Die Faser kann diese Daten mithilfe des Makros GetFiberData abrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Adresse der Faser.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Nur Fasern können andere Fasern ausführen. Wenn ein Thread eine Faser ausführen muss, muss er ConvertThreadToFiber oder ConvertThreadToFiberEx aufrufen, um einen Bereich zu erstellen, in dem Faserzustandsinformationen gespeichert werden. Der Thread ist jetzt die aktuelle Faser. Die Zustandsinformationen für diese Fasern enthalten die von lpParameter angegebenen Faserdaten.

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0400 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Beispiele

Ein Beispiel finden Sie unter Verwenden von Fasern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll