fonction TSPI_lineSetCallQualityOfService (tspi.h)
Le fournisseur de services de fonction TSPI_lineSetCallQualityOfService tente de renégocier la qos sur l’appel avec le commutateur Si la qoS souhaitée n’est pas disponible, la fonction échoue, mais l’appel continue avec la qoS précédente. Si la fonction réussit, les nouvelles informations QOS sont stockées dans LINECALLINFO ; un message LINECALLINFOSTATE_QOS est envoyé par le fournisseur de services pour indiquer les valeurs mises à jour.
Syntaxe
LONG TSPIAPI TSPI_lineSetCallQualityOfService(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
Paramètres
dwRequestID
Identificateur pour la création de rapports de résultats de fonction asynchrone.
hdCall
Handle du fournisseur de services pour l’appel.
lpSendingFlowspec
Pointeur vers la mémoire contenant une structure WinSock2 FLOWSPEC suivie de données spécifiques au fournisseur. La partie spécifique au fournisseur qui suit la structure FLOWSPEC ne doit pas contenir de pointeurs vers d’autres blocs de mémoire dans le processus d’application, car TAPI ne sait pas comment marshaler les données pointées par le ou les pointeurs privés et les transmettre par le biais d’une communication interprocesseur au fournisseur de services.
dwSendingFlowspecSize
Taille totale en octets de FLOWSPEC et des données spécifiques au fournisseur associées, équivalente à ce qui aurait été stocké dans SendingFlowspec.len dans une structure QOS WinSock2.
lpReceivingFlowspec
Pointeur vers la mémoire contenant une structure WinSock2 FLOWSPEC suivie de données spécifiques au fournisseur. La partie spécifique au fournisseur qui suit la structure FLOWSPEC ne doit pas contenir de pointeurs vers d’autres blocs de mémoire dans le processus d’application, car TAPI ne sait pas comment marshaler les données pointées par le ou les pointeurs privés et les transmettre par le biais d’une communication interprocesseur au fournisseur de services.
dwReceivingFlowspecSize
Taille totale en octets de FLOWSPEC et des données spécifiques au fournisseur associées, équivalente à ce qui aurait été stocké dans ReceiveingFlowspec.len dans une structure QOS WinSock2.
Valeur retournée
Retourne dwRequestID si l’opération asynchrone démarre ; sinon, la fonction retourne l’une des valeurs d’erreur négatives suivantes :
LINEERR_INVALCALLSTATE, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |