TSPI_lineGetAddressCaps, fonction (tspi.h)
La fonction TSPI_lineGetAddressCaps interroge l’adresse spécifiée sur l’appareil de ligne spécifié pour déterminer ses fonctionnalités de téléphonie.
Syntaxe
LONG TSPIAPI TSPI_lineGetAddressCaps(
DWORD dwDeviceID,
DWORD dwAddressID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEADDRESSCAPS lpAddressCaps
);
Paramètres
dwDeviceID
Périphérique de ligne contenant l’adresse à interroger.
dwAddressID
Adresse sur l’appareil de ligne donné dont les fonctionnalités doivent être interrogées. Un identificateur d’adresse est associé de manière permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation. Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.
dwTSPIVersion
Numéro de version du SPI de téléphonie à utiliser. Le mot d’ordre supérieur contient le numéro de version principale ; le mot d’ordre inférieur contient le numéro de version secondaire.
dwExtVersion
Numéro de version des extensions spécifiques au fournisseur de services à utiliser. Ce nombre est égal à zéro si aucune extension spécifique à l’appareil ne doit être utilisée. Sinon, le mot d’ordre supérieur contient le numéro de version principale ; le mot d’ordre inférieur contient le numéro de version secondaire. Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.
lpAddressCaps
Pointeur vers une structure de taille variable de type LINEADDRESSCAPS. Une fois la demande terminée, cette structure est remplie avec des informations sur les fonctionnalités d’adresse.
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_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL.
Remarques
Les identificateurs de périphérique de ligne pris en charge par un pilote particulier sont numérotés séquentiellement à partir de la valeur de dwLineDeviceIDBase qui est passée à la fonction TSPI_providerInit .
Le fournisseur de services remplit tous les membres de la structure de données LINEADDRESSCAPS , à l’exception de dwTotalSize, qui est renseigné par TAPI. Le fournisseur de services ne doit pas remplacer le membre dwTotalSize .
Une fois que le fournisseur de services est retourné à partir de la fonction TSPI_lineGetAddressCaps , TAPI définit les membres dwCallInfoStates et dwCallStates de la structure LINEADDRESSCAPS comme suit :
LINEADDRESSCAPS.dwCallInfoStates |=
LINECALLINFOSTATE_NUMOWNERINCR |
LINECALLINFOSTATE_NUMOWNERDECR |
LINECALLINFOSTATE_NUMMONITORS;
LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |