ConvertThreadToFiberEx-Funktion (winbase.h)

  • Artikel

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 ConvertThreadToFiberEx(
  [in, optional] LPVOID lpParameter,
  [in]           DWORD  dwFlags
);

Parameter

[in, optional] lpParameter

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

[in] dwFlags

Wenn dieser Parameter null ist, wird der Gleitkommazustand auf x86-Systemen nicht gewechselt, und Daten können beschädigt werden, wenn eine Faser Gleitkommaarithmetik verwendet. Wenn dieser Parameter FIBER_FLAG_FLOAT_SWITCH ist, wird der Gleitkommazustand für die Glasfaser gewechselt.

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 ConvertTheadToFiber 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 Faser 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.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

ConvertFiberToThread

Fasern

GetFiberData

Prozess- und Threadfunktionen