lineSetCallQualityOfService, fonction (tapi.h)
La fonction lineSetCallQualityOfService permet à l’application de tenter de modifier les paramètres de qualité de service (garanties de capacité et de performances réservées) pour un appel existant. À l’exception de la validation de paramètre de base, il s’agit d’un passage direct direct vers un fournisseur de services.
Syntaxe
LONG lineSetCallQualityOfService(
HCALL hCall,
LPVOID lpSendingFlowspec,
DWORD dwSendingFlowspecSize,
LPVOID lpReceivingFlowspec,
DWORD dwReceivingFlowspecSize
);
Paramètres
hCall
Gérer l’appel. L’application doit avoir le privilège OWNER.
lpSendingFlowspec
Pointeur vers la mémoire contenant une structure 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 vers le fournisseur de services.
dwSendingFlowspecSize
Taille totale de la structure FLOWSPEC et des données spécifiques au fournisseur associées, en octets. Cela équivaut à ce qui aurait été stocké dans SendingFlowspec dans une structure QOS .
lpReceivingFlowspec
Pointeur vers la mémoire contenant une structure 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 vers le fournisseur de services.
dwReceivingFlowspecSize
Taille totale du FLOWSPEC et des données spécifiques au fournisseur associées, en octets. Cela équivaut à ce qui aurait été stocké dans ReceiveingFlowspec dans une structure QOS .
Valeur retournée
Retourne un identificateur de demande positif si l’opération asynchrone démarre ; sinon, la fonction retourne l’une des valeurs d’erreur négatives suivantes :
LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.
Configuration requise
| Plateforme cible | Windows |
| En-tête | tapi.h |
| Bibliothèque | Tapi32.lib |
| DLL | Tapi32.dll |