Função ConvertThreadToFiber (winbase.h)

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

Confira também

ConvertFiberToThread

ConvertThreadToFiberEx

Fibras

GetFiberData

Funções de thread e processo