Функция lineSetCallQualityOfService (tapi.h)

Статья
08/26/2023

Функция lineSetCallQualityOfService позволяет приложению попытаться изменить качество параметров службы (зарезервированную емкость и гарантии производительности) для существующего вызова. За исключением проверки базовых параметров, это прямая передача поставщику услуг.

Синтаксис

LONG lineSetCallQualityOfService(
  HCALL  hCall,
  LPVOID lpSendingFlowspec,
  DWORD  dwSendingFlowspecSize,
  LPVOID lpReceivingFlowspec,
  DWORD  dwReceivingFlowspecSize
);

Параметры

hCall

Дескриптор вызова. Приложение должно иметь привилегию OWNER.

lpSendingFlowspec

Указатель на память, содержащую структуру FLOWSPEC , за которой следуют данные конкретного поставщика. Часть конкретного поставщика, следующая за структурой FLOWSPEC , не должна содержать указателей на другие блоки памяти в процессе приложения, так как TAPI не будет знать, как маршалировать данные, на которые указывают частные указатели, и передавать их через межпроцессное взаимодействие с поставщиком услуг.

dwSendingFlowspecSize

Общий размер структуры FLOWSPEC и сопутствующих данных конкретного поставщика в байтах. Это эквивалентно тому, что было бы сохранено в SendingFlowspec в структуре QOS .

lpReceivingFlowspec

Указатель на память, содержащую структуру FLOWSPEC , за которой следуют данные конкретного поставщика. Часть конкретного поставщика, следующая за структурой FLOWSPEC , не должна содержать указателей на другие блоки памяти в процессе приложения, так как TAPI не будет знать, как маршалировать данные, на которые указывают частные указатели, и передавать их через межпроцессное взаимодействие с поставщиком услуг.

dwReceivingFlowspecSize

Общий размер FLOWSPEC и сопутствующих данных конкретного поставщика в байтах. Это эквивалентно тому, что было бы сохранено в ReceivingFlowspec в структуре QOS .

Возвращаемое значение

Возвращает положительный идентификатор запроса, если начинается асинхронная операция; В противном случае функция возвращает одно из следующих отрицательных значений ошибки:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_INVALRATE, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RATEUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.