lineSetCallQualityOfService, fonction (tapi.h)

Article
08/26/2023

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.