TSPI_lineGetDevCaps, fonction (tspi.h)
La fonction TSPI_lineGetDevCaps interroge un appareil de ligne spécifié pour déterminer ses fonctionnalités de téléphonie. Les informations retournées sont valides pour toutes les adresses de l’appareil de ligne.
Syntaxe
LONG TSPIAPI TSPI_lineGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
Paramètres
dwDeviceID
Périphérique de ligne à interroger.
dwTSPIVersion
Numéro de version TSPI négocié. Cette valeur a déjà été négociée pour cet appareil via la fonction TSPI_lineNegotiateTSPIVersion .
dwExtVersion
Numéro de version d’extension négocié. Cette valeur a déjà été négociée pour cet appareil via la fonction TSPI_lineNegotiateExtVersion . Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.
lpLineDevCaps
Pointeur vers une structure de taille variable de type LINEDEVCAPS. Une fois la demande terminée, cette structure est remplie avec des informations sur les fonctionnalités de l’appareil en ligne.
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_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Remarques
La numérotation de l’identificateur de périphérique de ligne pour un fournisseur de services est séquentielle à partir de la valeur définie par le paramètre dwLineDeviceIDBase qui est passé à la fonction TSPI_providerInit .
Le paramètre formel dwExtVersion indique le numéro de version des informations d’extension demandées. S’il est égal à zéro, aucune information d’extension n’est demandée. S’il est différent de zéro, il contient une valeur qui a été négociée pour cet appareil avec la fonction TSPI_lineNegotiateExtVersion . Le fournisseur de services renseigne des informations étendues spécifiques à l’appareil et au fournisseur en fonction de la version d’extension spécifiée.
Le fournisseur de services remplit tous les membres de la structure de données LINEDEVCAPS , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .
Le fournisseur de services doit renseigner tous les membres de la structure de données LINETERMCAPS ou des structures incorporées dans la partie variable de la structure de données LINEDEVCAPS .
Une fois que le fournisseur de services est retourné à partir de la fonction TSPI_lineGetDevCaps , TAPI définit le membre dwLinesStates de la structure LINEDEVCAPS comme suit :
LINEDEVCAPS.dwLineStates |=
LINEDEVSTATE_OPEN |
LINEDEVSTATE_CLOSE |
LINEDEVSTATE_REINIT |
LINEDEVSTATE_TRANSLATECHANGE;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |