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

Voir aussi

LINEDEVCAPS

LINETERMCAPS

TSPI_lineNegotiateExtVersion

TSPI_lineNegotiateTSPIVersion

TSPI_providerInit