ASYNC_COMPLETION fonction de rappel (tspi.h)
Completion_Proc est une fonction de rappel implémentée par TAPI et fournie au fournisseur de services en tant que paramètre pour TSPI_providerInit. Le fournisseur de services appelle cette fonction pour signaler l’achèvement d’une ligne ou d’une procédure téléphonique qu’il exécute de manière asynchrone.
Le type ASYNC_COMPLETION définit un pointeur vers cette fonction de rappel. Completion_Proc est un espace réservé pour le nom de fonction défini par l’application.
Syntaxe
ASYNC_COMPLETION AsyncCompletion;
void AsyncCompletion(
DRV_REQUESTID dwRequestID,
LONG lResult
)
{...}
Paramètres
dwRequestID
Identificateur transmis dans la demande d’origine que le fournisseur de services a exécutée de façon asynchrone.
lResult
Résultat de l’opération. Il peut s’agir de zéro pour indiquer la réussite ou d’un nombre négatif pour indiquer une erreur. Les valeurs d’erreur spécifiques possibles qui peuvent résulter d’une fonction sont les mêmes pour l’exécution asynchrone ou synchrone.
Valeur de retour
None
Remarques
L’état d’appel lors de l’appel de cette fonction peut être n’importe quel état.
Cette procédure est fournie par TAPI au moment où un fournisseur de services est initialisé avec la fonction TSPI_providerInit . Certaines procédures TSPI qui fonctionnent sur les appareils en ligne, les appels et les appareils téléphoniques spécifient une opération asynchrone. Ces procédures incluent un paramètre dwRequestID pour identifier la demande. Quand une telle procédure est appelée, le fournisseur de services peut retourner un nombre négatif pour une erreur si une erreur est détectée immédiatement, ou le dwRequestID positif si l’opération se poursuit de manière asynchrone. Le fournisseur de services doit signaler l’achèvement exactement une fois pour chaque requête qu’il exécute de façon asynchrone. Pour ce faire, il appelle cette procédure. Le fournisseur de services n’est pas autorisé à appeler cette procédure ou la procédure Line_Event ou Phone_Event à nouveau tant que cette procédure n’est pas retournée.
Le fournisseur de services est autorisé à appeler la fonction Completion_Proc avant qu’elle ne retourne à partir de la première requête. TAPI garantit de ne pas appeler le fournisseur de services à partir du contexte Completion_Proc , sauf indication contraire.
Cela n’a pas de correspondance directe au niveau TAPI, car à ce niveau, les complétions asynchrones de fonction sont signalées en tant que message transmis via la même interface de rappel que celle utilisée pour les messages d’événements spontanés. Au niveau de la TSPI, les événements spontanés sont signalés par le biais des procédures de rappel Line_Event et Phone_Event .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |