Função CreateThreadpoolIo (threadpoolapiset.h)

Artigo
03/05/2024

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