fonction TSPI_lineSetDefaultMediaDetection (tspi.h)
La procédure TSPI_lineSetDefaultMediaDetection indique au fournisseur de services le nouvel ensemble de types de supports à détecter pour la ligne indiquée (en remplaçant tout jeu précédent). Il définit également l’ensemble initial de types de médias qui doivent être surveillés sur les appels suivants (entrants ou sortants) sur cette ligne.
Syntaxe
LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
HDRVLINE hdLine,
DWORD dwMediaModes
);
Paramètres
hdLine
Handle de la ligne à disposer d’un jeu de surveillance multimédia.
dwMediaModes
Type(s) multimédia(s) d’intérêt pour TAPI. Ce paramètre utilise l’une des constantes LINEMEDIAMODE_ :
Valeur retournée
Retourne 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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL.
Remarques
TAPI appelle généralement cette fonction pour mettre à jour l’ensemble des types de médias détectés pour la ligne vers l’union de tous les modes sélectionnés par tous les modes de ligne en attenteOuvrir chaque fois qu’une ligne est ouverte ou fermée au niveau TAPI. Une tentative d’appel lineOpen est rejetée si la détection du média est rejetée. Un seul appel à cette procédure est généralement le résultat d’un appel lineOpen qui ne spécifie pas l’identificateur d’appareil LINEMAPPER. L’identificateur d’appareil LINEMAPPER n’est jamais utilisé au niveau TSPI.
TAPI doit calculer l’union des types de médias souhaités par tous les clients et passer le résultat à cette fonction. Le fournisseur de services utilise l’ensemble passé à cette fonction par TAPI. TAPI garantit que le paramètre dwMediaModes a au moins un ensemble de bits et qu’aucun bits réservé n’est défini. Le fournisseur de services doit effectuer d’autres vérifications de validité sur les types de médias, par exemple vérifier si les types de médias sont effectivement pris en charge par le fournisseur de services. L’union de tous les types de médias peut être la valeur 0 si les applications dont la ligne est ouverte sont toutes des moniteurs ou ne sont pas intéressées par la gestion des appels entrants.
Il n’existe aucune fonction correspondant directement au niveau TAPI. Cette procédure correspond aux « types de supports de requête » impliqués pour la ligne spécifique par la procédure lineOpen lorsqu’elle est appelée avec l’identificateur d’appareil spécifique (autre que LINEMAPPER).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |