Função ConvertThreadToFiber (winbase.h)

Artigo
03/03/2024

Converte o thread atual em uma fibra. Você deve converter um thread em uma fibra antes de agendar outras fibras.

Sintaxe

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

Parâmetros

[in, optional] lpParameter

Um ponteiro para uma variável que é passada para a fibra. A fibra pode recuperar esses dados usando a macro GetFiberData .

Retornar valor

Se a função for bem-sucedida, o valor retornado será o endereço da fibra.

Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Somente fibras podem executar outras fibras. Se um thread precisar executar uma fibra, ele deverá chamar ConvertThreadToFiber ou ConvertThreadToFiberEx para criar uma área na qual salvar informações de estado de fibra. O thread agora é a fibra atual. As informações de estado dessa fibra incluem os dados de fibra especificados por lpParameter.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0400 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.

Exemplos

Para obter um exemplo, consulte Usando fibras.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winbase.h (incluir Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll