TSPI_lineOpen fonction (tspi.h)

Article
03/06/2024

La fonction TSPI_lineOpen ouvre l’appareil de ligne dont l’identificateur d’appareil est donné, en retournant le handle du fournisseur de services pour l’appareil. Le fournisseur de services doit conserver le handle TAPI de l’appareil pour l’utiliser dans les appels suivants à la procédure de rappel LINEEVENT .

Syntaxe

LONG TSPIAPI TSPI_lineOpen(
  DWORD      dwDeviceID,
  HTAPILINE  htLine,
  LPHDRVLINE lphdLine,
  DWORD      dwTSPIVersion,
  LINEEVENT  lpfnEventProc
);

Paramètres

dwDeviceID

Identifie l’appareil de ligne à ouvrir.

htLine

Handle TAPI pour l’appareil de ligne à utiliser dans les appels suivants à la procédure de rappel LINEEVENT pour identifier l’appareil.

lphdLine

Pointeur vers un HDRVLINE où le fournisseur de services remplit sa poignée pour l’appareil de ligne.

dwTSPIVersion

Version TSPI.

lpfnEventProc

Pointeur vers la procédure de rappel LINEEVENT fournie par TAPI que le fournisseur de services appelle pour signaler les événements suivants sur 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_ALLOCATED, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.

Remarques

Le fournisseur de services doit réserver toutes les ressources non partageables requises pour gérer la ligne. Toutefois, toutes les actions qui peuvent être reportées à lineMakeCall doivent l’être. Il s’agit d’une hypothèse de conception dans TAPI que lineOpen est une opération « peu coûteuse ». Par exemple, si la ligne est ouverte en mode moniteur uniquement, il ne doit pas être nécessaire qu’un fournisseur de services basé sur un port COMM ouvre le port COMM.

Cette procédure ne correspond pas directement à une procédure au niveau TAPI, où les fonctions d’activation d’extensions spécifiques à l’appareil, de sélection des caractéristiques de ligne et de définition de la détection du type de média sont incluses dans la fonctionnalité définie par lineOpen. Au niveau du TSPI, ces fonctionnalités supplémentaires sont réparties en TSPI_lineNegotiateExtVersion, TSPI_lineSetDefaultMediaDetection et TSPI_lineConditionalMediaDetection.