Fonction ConvertThreadToFiber (winbase.h)

Article
03/06/2024

Convertit le thread actuel en fibre. Vous devez convertir un thread en fibre avant de pouvoir planifier d’autres fibres.

Syntaxe

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

Paramètres

[in, optional] lpParameter

Pointeur vers une variable passée à la fibre. La fibre peut récupérer ces données à l’aide de la macro GetFiberData .

Valeur retournée

Si la fonction réussit, la valeur de retour est l’adresse de la fibre.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Seules les fibres peuvent exécuter d’autres fibres. Si un thread doit exécuter une fibre, il doit appeler ConvertThreadToFiber ou ConvertThreadToFiberEx pour créer une zone dans laquelle enregistrer les informations d’état de la fibre. Le thread est maintenant la fibre actuelle. Les informations d’état de cette fibre incluent les données de fibre spécifiées par lpParameter.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0400 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

Pour obtenir un exemple, consultez Utilisation de fibres.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll