Função WaitForThreadpoolIoCallbacks (threadpoolapiset.h)

Aguarda a conclusão dos retornos de chamada de conclusão de E/S pendentes e, opcionalmente, cancela os retornos de chamada pendentes que ainda não começaram a ser executados.

Sintaxe

void WaitForThreadpoolIoCallbacks(
  [in, out] PTP_IO pio,
  [in]      BOOL   fCancelPendingCallbacks
);

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.

[in] fCancelPendingCallbacks

Indica se os retornos de chamada enfileirados que ainda não começaram a ser executados devem ser cancelados.

Retornar valor

Nenhum

Comentários

Quando fCancelPendingCallbacks é definido como TRUE, somente os retornos de chamada enfileirados são cancelados. As solicitações de E/S pendentes não são canceladas. Portanto, o chamador deve chamar GetOverlappedResult para que a estrutura OVERLAPPED marcar se a operação de E/S foi concluída antes de liberar a estrutura. Como alternativa, defina fCancelPendingCallbacks como FALSE e tenha o retorno de chamada de conclusão de E/S associado livre da estrutura OVERLAPPED . Tenha cuidado para não liberar a estrutura OVERLAPPED enquanto as solicitações de E/S ainda estiverem pendentes; use GetOverlappedResult para determinar o status da operação de E/S e aguardar a conclusão da operação. Opcionalmente, a função CancelIoEx pode ser usada primeiro para cancelar solicitações de E/S pendentes, potencialmente reduzindo a espera. Para obter mais informações, consulte Cancelando operações de E/S pendentes.

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

Requisitos

Confira também

CancelThreadpoolIo

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Pools de threads