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 |