Função CreateThreadpoolIo (threadpoolapiset.h)

Cria um novo objeto de conclusão de E/S.

Sintaxe

PTP_IO CreateThreadpoolIo(
  [in]                HANDLE                fl,
  [in]                PTP_WIN32_IO_CALLBACK pfnio,
  [in, out, optional] PVOID                 pv,
  [in, optional]      PTP_CALLBACK_ENVIRON  pcbe
);

Parâmetros

[in] fl

O identificador de arquivo a ser associado a esse objeto de conclusão de E/S.

[in] pfnio

A função de retorno de chamada a ser chamada sempre que uma operação de E/S sobreposta for concluída no arquivo. Para obter detalhes, consulte IoCompletionCallback.

[in, out, optional] pv

Dados opcionais definidos pelo aplicativo para passar para a função de retorno de chamada.

[in, optional] pcbe

Um ponteiro para uma estrutura TP_CALLBACK_ENVIRON que define o ambiente no qual executar o retorno de chamada. Use a função InitializeThreadpoolEnvironment para inicializar a estrutura antes de chamar essa função.

Se esse parâmetro for NULL, o retorno de chamada será executado no ambiente de retorno de chamada padrão. Para obter mais informações, consulte InitializeThreadpoolEnvironment.

Retornar valor

Se a função for bem-sucedida, ela retornará um ponteiro para uma estrutura TP_IO que define o objeto de E/S. Os aplicativos não modificam os membros dessa estrutura.

Se a função falhar, ela retornará NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Para começar a receber retornos de chamada de conclusão de E/S sobrepostos, chame a função StartThreadpoolIo .

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 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

StartThreadpoolIo

Pools de threads

WaitForThreadpoolIoCallbacks