Função StartThreadpoolIo (threadpoolapiset.h)

Notifica o pool de threads de que as operações de E/S podem possivelmente começar para o objeto de conclusão de E/S especificado. Um thread de trabalho chama a função de retorno de chamada do objeto de conclusão de E/S após a conclusão da operação no identificador de arquivo associado a esse objeto.

Sintaxe

void StartThreadpoolIo(
  [in, out] PTP_IO pio
);

Parâmetros

[in, out] pio

Um ponteiro para uma estrutura TP_IO que define o objeto de conclusão de E/S. A função CreateThreadpoolIo retorna esse ponteiro.

Retornar valor

Nenhum

Comentários

Você deve chamar essa função antes de iniciar cada operação de E/S assíncrona no identificador de arquivo associado ao objeto de conclusão de E/S. A falha ao fazer isso fará com que o pool de threads ignore uma operação de E/S quando for concluída e causará corrupção de memória.

Se a operação de E/S falhar, chame a função CancelThreadpoolIo para cancelar essa notificação.

Se o identificador de arquivo associado ao objeto de conclusão de E/S tiver o modo de notificação FILE_SKIP_COMPLETION_PORT_ON_SUCCESS e uma operação de E/S assíncrona retornar imediatamente com êxito, a função de retorno de chamada de conclusão de E/S do objeto não será chamada e as notificações de E/S do threadpool deverão ser canceladas. Para obter mais informações, consulte CancelThreadpoolIo.

Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho threadpoolapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

Pools de threads

WaitForThreadpoolIoCallbacks