fonction lineGetRequest (tapi.h)

Article
03/04/2024

La fonction lineGetRequest récupère la requête de proxy de by suivante pour le mode de requête spécifié.

Syntaxe

LONG lineGetRequest(
  HLINEAPP hLineApp,
  DWORD    dwRequestMode,
  LPVOID   lpRequestBuffer
);

Paramètres

hLineApp

Handle d’utilisation de l’application pour la partie ligne de TAPI.

dwRequestMode

Type de demande à obtenir. N’oubliez pas que dwRequestMode ne peut avoir qu’un seul ensemble de bits. Ce paramètre utilise une seule des constantes LINEREQUESTMODE_.

lpRequestBuffer

Pointeur vers une mémoire tampon où les paramètres de la demande doivent être placés. La taille de la mémoire tampon et l’interprétation des données placées dans la mémoire tampon dépendent du mode de requête. La mémoire tampon allouée par l’application est supposée être de taille suffisante pour contenir la demande.

Si dwRequestMode est LINEREQUESTMODE_MAKECALL, interprétez le contenu de la mémoire tampon de requête à l’aide de la structure LINEREQMAKECALL .

LINEREQUESTMODE_MEDIACALL est obsolète. Pour plus d’informations, consultez tapiRequestMediaCall.

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALAPPHANDLE, LINEERR_NOTREGISTERED, LINEERR_INVALPOINTER, LINEERR_OPERATIONFAILED, LINEERR_INVALREQUESTMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOREQUEST.

Remarques

Une application avec téléphonie peut demander qu’un appel soit placé en son nom en appelant tapiRequestMakeCall. Ces demandes sont mises en file d’attente par TAPI et l’application de priorité la plus élevée qui s’est inscrite pour gérer la demande reçoit un message LINE_REQUEST avec l’indication du mode de la demande en attente. En règle générale, cette application est l’application de contrôle d’appel de l’utilisateur. Le message LINE_REQUEST indique qu’aucune ou plusieurs demandes peuvent être en attente pour que l’application inscrite soit traitée ; après avoir reçu LINE_REQUEST, il incombe à l’application destinataire d’appeler lineGetRequest jusqu’à ce que LINEERR_NOREQUEST soit retourné, ce qui indique qu’aucune autre demande n’est en attente.

Ensuite, l’application de contrôle d’appel qui reçoit ce message appelle lineGetRequest, en spécifiant le mode de requête et une mémoire tampon suffisamment grande pour contenir la demande. L’application de contrôle d’appel interprète et exécute ensuite la demande.

Après l’exécution de lineGetRequest, TAPI vide la requête de sa file d’attente interne, ce qui rend la place disponible pour une requête suivante. Il est donc possible qu’un nouveau message LINE_REQUEST soit reçu immédiatement après l’exécution de lineGetRequest, si la même application ou une autre application émet une autre demande. Il incombe à l’application destinataire de la demande de gérer ce scénario par un mécanisme quelconque ; par exemple, en notant les LINE_REQUEST supplémentaires et en reportant une requête lineGetRequest suivante jusqu’à ce que le traitement de la demande précédente soit terminé, en obtenant la requête et la mémoire tampon suivantes si nécessaire, ou par un autre moyen approprié.

La LINE_REQUEST suivante ne doit pas être ignorée, car elle n’est pas répétée par TAPI.