Funzione ConvertThreadToFiber (winbase.h)

Articolo
03/03/2024

Converte il thread corrente in una fibra. È necessario convertire un thread in una fibra prima di poter pianificare altre fibre.

Sintassi

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

Parametri

[in, optional] lpParameter

Puntatore a una variabile passata alla fibra. La fibra può recuperare questi dati usando la macro GetFiberData .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è l'indirizzo della fibra.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Solo le fibre possono eseguire altre fibre. Se un thread deve eseguire una fibra, deve chiamare ConvertThreadToFiber o ConvertThreadToFiberEx per creare un'area in cui salvare le informazioni sullo stato della fibra. Il thread è ora la fibra corrente. Le informazioni sullo stato per questa fibra includono i dati fibre specificati da lpParameter.

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0400 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Esempio

Per un esempio, vedere Uso di fibre.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll