Функция lineSetCallQualityOfService (tapi.h)
Функция 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.
Требования
Целевая платформа | Windows |
Header | tapi.h |
Библиотека | Tapi32.lib |
DLL | Tapi32.dll |