Функция NdisClModifyCallQoS (ndis.h)
NdisClModifyCallQoS запрашивает изменение качества обслуживания при подключении.
Синтаксис
NDIS_STATUS NdisClModifyCallQoS(
[in] NDIS_HANDLE NdisVcHandle,
[in] PCO_CALL_PARAMETERS CallParameters
);
Параметры
[in] NdisVcHandle
Указывает дескриптор для проверяемого удостоверения, для которого клиент хочет изменить качество обслуживания. Клиент первоначально получил этот дескриптор, вызвав NdisCoCreateVc, а совсем недавно извлек этот дескриптор из области состояния per-VC.
[in] CallParameters
Указатель на структуру типа CO_CALL_PARAMETERS, указывающую новый QoS, запрошенный вызывающим.
Возвращаемое значение
Когда NdisClModifyCallQoS возвращает что-либо, кроме NDIS_STATUS_PENDING, клиент должен выполнить внутренний вызов Функция ProtocolClModifyCallQoSComplete . В противном случае NDIS вызывает функцию ProtocolClModifyCallQoSComplete клиента после завершения этой операции.
Комментарии
Вызов NdisClModifyCallQoS вызывает NDIS для вызова CM Функция ProtocolCmModifyCallQoS , которая, в свою очередь, вызывает NdisCmActivateVc , чтобы уведомить базовый драйвер мини-порта об изменении параметров вызова, если можно внести запрошенные изменения качества обслуживания.
Если диспетчер вызовов не принимает предлагаемое изменение качества обслуживания клиента, клиент может продолжать использовать неизменяемое QoS для вызова или может отключить вызов. Если клиент и диспетчер вызовов не могут договориться о QoS для конкретного вызова, создатель VC несет ответственность за инициирование удаления VC.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisClModifyCallQoS (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisClModifyCallQoS (NDIS 5.1)) в Windows XP. |
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ndis.h (включая Ndis.h) |
| Библиотека | Ndis.lib |
| IRQL | <= DISPATCH_LEVEL |
| Правила соответствия DDI | Irql_Protocol_Driver_Function(ndis) |