ASYNC_COMPLETION função de retorno de chamada (tspi.h)

Artigo
03/13/2024

Completion_Proc é uma função de retorno de chamada implementada pelo TAPI e fornecida ao provedor de serviços como um parâmetro para TSPI_providerInit. O provedor de serviços chama essa função para relatar a conclusão de um procedimento de linha ou telefone que ele executa de forma assíncrona.

O tipo ASYNC_COMPLETION define um ponteiro para essa função de retorno de chamada. Completion_Proc é um espaço reservado para o nome da função definida pelo aplicativo.

Sintaxe

ASYNC_COMPLETION AsyncCompletion;

void AsyncCompletion(
  DRV_REQUESTID dwRequestID,
  LONG lResult
)
{...}

Parâmetros

dwRequestID

O identificador passou na solicitação original que o provedor de serviços executou de forma assíncrona.

lResult

O resultado da operação. Isso pode ser zero para indicar êxito ou um número negativo para indicar um erro. Os possíveis valores de erro específicos que podem resultar de uma função são os mesmos para execução assíncrona ou síncrona.

Retornar valor

Nenhum

Comentários

O estado de chamada ao chamar essa função pode ser qualquer estado.

Esse procedimento é fornecido pelo TAPI no momento em que um provedor de serviços é inicializado com a função TSPI_providerInit . Alguns dos procedimentos TSPI que operam em dispositivos de linha, chamada e telefone especificam a operação assíncrona. Esses procedimentos incluem um parâmetro dwRequestID para identificar a solicitação. Quando esse procedimento é chamado, o provedor de serviços pode retornar um número negativo para um erro se for detectado imediatamente ou o dwRequestID positivo se a operação continuar de forma assíncrona. O provedor de serviços deve relatar a conclusão exatamente uma vez para cada solicitação executada de forma assíncrona. Ele faz isso chamando este procedimento. O provedor de serviços não tem permissão para chamar esse procedimento ou o procedimento Line_Event ou Phone_Event novamente até que este procedimento retorne.

O provedor de serviços tem permissão para chamar a função Completion_Proc antes de retornar da primeira solicitação. O TAPI garante não chamar o provedor de serviços de dentro do contexto de Completion_Proc , exceto quando indicado.

Isso não tem nenhuma correspondência direta no nível tapi porque nesse nível as conclusões de função assíncrona são relatadas como uma mensagem passada pela mesma interface de retorno de chamada usada para mensagens de evento espontâneos. No nível do TSPI, eventos espontâneos são relatados por meio do Line_Event e Phone_Event procedimentos de retorno de chamada.