fonction TSPI_lineReleaseUserUserInfo (tspi.h)
La fonction TSPI_lineReleaseUserUserInfo informe le fournisseur de services que les informations utilisateur-utilisateur contenues dans la structure LINECALLINFO ont été traitées et que les informations utilisateur-utilisateur reçues ultérieurement peuvent désormais être écrites dans cette structure. Le fournisseur de services envoie un message LINE_CALLINFO indiquant LINECALLINFOSTATE_USERUSERINFO lorsque de nouvelles informations sont disponibles.
Syntaxe
LONG TSPIAPI TSPI_lineReleaseUserUserInfo(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdCall
Le handle du fournisseur de services à l’appel pour lequel les informations utilisateur-utilisateur doivent être publiées. L’état de l’appel de hdCall peut être n’importe lequel.
Valeur retournée
Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est zéro si la fonction réussit, ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Remarques
La fonction TSPI_lineReleaseUserUserInfo permet de contrôler le flux d’informations utilisateur entrantes sur une connexion ISDN. Lorsqu’un nouveau message complet d’informations utilisateur est reçu, le fournisseur de services informe TAPI à l’aide d’un message LINE_CALLINFO (spécifiant LINECALLINFOSTATE_USERUSERINFO). Les informations utilisateur-utilisateur et d’autres champs de LINECALLINFO peuvent être examinés par plusieurs appels à TSPI_lineGetCallInfo. Le fournisseur de services ne doit pas remplacer les informations utilisateur-utilisateur précédentes dans LINECALLINFO par des informations plus récentes tant que TSPI_lineReleaseUserUserInfo n’a pas été appelé. Le fournisseur de services doit mettre en mémoire tampon les informations utilisateur reçues ultérieurement jusqu’à ce que les informations précédentes soient publiées. Toutes les informations mises en mémoire tampon restantes peuvent être ignorées lorsque TSPI_lineCloseCall est appelé.
Si cette fonction est appelée alors qu’il n’existe aucune information utilisateur dans LINECALLINFO, le fournisseur de services doit néanmoins retourner une indication de réussite.
À des fins de compatibilité descendante, TAPI retourne automatiquement LINEERR_OPERATIONUNAVAIL si cette fonction est appelée pour un appel sur une ligne sous le contrôle d’un fournisseur de services qui n’exporte pas la fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |