Função CreateFiberEx (winbase.h)

Artigo
03/03/2024

Aloca um objeto de fibra, atribui uma pilha a ele e configura a execução para começar no endereço inicial especificado, normalmente a função de fibra. Essa função não agenda a fibra.

Sintaxe

LPVOID CreateFiberEx(
  [in]           SIZE_T                dwStackCommitSize,
  [in]           SIZE_T                dwStackReserveSize,
  [in]           DWORD                 dwFlags,
  [in]           LPFIBER_START_ROUTINE lpStartAddress,
  [in, optional] LPVOID                lpParameter
);

Parâmetros

[in] dwStackCommitSize

O tamanho inicial da confirmação da pilha, em bytes. Se esse parâmetro for zero, a nova fibra usará o tamanho da pilha de confirmação padrão para o executável. Para obter mais informações, consulte Tamanho da pilha do thread.

[in] dwStackReserveSize

O tamanho inicial da reserva da pilha, em bytes. Se esse parâmetro for zero, a nova fibra usará o tamanho de pilha reservado padrão para o executável. Para obter mais informações, consulte Tamanho da pilha do thread.

[in] dwFlags

Se esse parâmetro for zero, o estado de ponto flutuante em sistemas x86 não será alternado e os dados poderão ser corrompidos se uma fibra usar aritmética de ponto flutuante. Se esse parâmetro for FIBER_FLAG_FLOAT_SWITCH, o estado de ponto flutuante será alternado para a fibra.

Windows XP: Não há suporte para o sinalizador FIBER_FLAG_FLOAT_SWITCH .

[in] lpStartAddress

Um ponteiro para a função definida pelo aplicativo a ser executada pela fibra e representa o endereço inicial da fibra. A execução da fibra recém-criada não começa até que outra fibra chame a função SwitchToFiber com esse endereço. Para obter mais informações sobre a função de retorno de chamada de fibra, consulte FiberProc.

[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

O número de fibras que um processo pode criar é limitado pela memória virtual disponível. Por padrão, cada fibra tem 1 megabyte de espaço de pilha reservado. Portanto, você pode criar no máximo 2028 fibras. Se você reduzir o tamanho da pilha padrão, poderá criar mais fibras. No entanto, seu aplicativo terá melhor desempenho se você usar uma estratégia alternativa para processar solicitações.

Antes que um thread possa agendar uma fibra usando a função SwitchToFiber , ele deve chamar a função ConvertThreadToFiber para que haja uma fibra associada ao thread.

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.

Requisitos

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