TSPI_lineGetLineDevStatus, fonction (tspi.h)
La fonction TSPI_lineGetLineDevStatus interroge l’appareil de ligne ouverte spécifié pour son status actuel. Les informations retournées sont globales pour toutes les adresses sur la ligne.
Syntaxe
LONG TSPIAPI TSPI_lineGetLineDevStatus(
HDRVLINE hdLine,
LPLINEDEVSTATUS lpLineDevStatus
);
Paramètres
hdLine
Handle du fournisseur de services à la ligne à interroger.
lpLineDevStatus
Pointeur vers une structure de données de taille variable de type LINEDEVSTATUS. Cette structure est remplie avec les status d’appareil de la 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_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_OPERATIONUNAVAIL.
Remarques
Le tableau suivant indique les membres de la structure de données LINEDEVSTATUS qui sont renseignés par TAPI et ceux qui sont renseignés par le fournisseur de services. Le fournisseur de services doit conserver (il ne doit pas remplacer) les valeurs renseignées par TAPI.
| Nom du membre | TAPI | Fournisseur de services |
|---|---|---|
| dwTotalSize ; | X | |
| dwNeededSize ; | X | |
| dwUsedSize ; | X | |
| dwNumOpens ; | X | |
| dwOpenMediaModes ; | X | |
| dwNumActiveCalls ; | X | |
| dwNumOnHoldCalls ; | X | |
| dwNumOnHoldPendCalls ; | X | |
| dwLineFeatures ; | X | |
| dwNumCallCompletions ; | X | |
| dwRingMode ; | X | |
| dwSignalLevel ; | X | |
| dwBatteryLevel ; | X | |
| dwRoamMode ; | X | |
| dwDevStatusFlags ; | X | |
| dwTerminalModesSize ; | X | |
| dwTerminalModesOffset ; | X | |
| dwDevSpecificSize ; | X | |
| dwDevSpecificOffset ; | X |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |