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

Voir aussi

LINEDEVSTATUS

TSPI_lineGetAddressStatus