Функция 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)

См. также раздел

CO_CALL_PARAMETERS

MiniportCoActivateVc

NdisClCloseCall

NdisCmModifyCallQoSComplete

NdisCoCreateVc

ProtocolClModifyCallQoSComplete

ProtocolCmModifyCallQoS