Функция NdisCmDispatchIncomingCallQoSChange (ndis.h)

Статья
02/26/2024

NdisCmDispatchIncomingCallQoSChange уведомляет клиента о получении запроса на изменение качества обслуживания при активном подключении этого клиента по сети.

Синтаксис

void NdisCmDispatchIncomingCallQoSChange(
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Параметры

[in] NdisVcHandle

Указывает дескриптор для VC, для которого запрашивается изменение в QoS. Диспетчер вызовов первоначально получил этот дескриптор либо при вызове NdisCoCreateVc , чтобы настроить это подключение для входящего вызова, либо в качестве входного параметра для своей функции ProtocolCoCreateVc .

[in] CallParameters

Указатель на структуру типа CO_CALL_PARAMETERS , указывающую новое качество обслуживания, запрошенное клиентом на удаленном узле, для этого подключения.

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

None

Remarks

Автономный диспетчер вызовов вызывает NdisCmDispatchIncomingCallQoSChange , чтобы уведомить клиента о том, что он получил запрос на изменение QoS при активном подключении. Такая cm поддерживает динамические изменения качества обслуживания при активных вызовах, что является такой функцией, как QoS, которая зависит от протокола сигнализации.

Когда cm сама получает запрос на изменение качества обслуживания, диспетчер вызовов передает соответствующим образом измененные параметры вызова в NdisCmActivateVc, поэтому базовый драйвер минипорта также получает уведомление о предлагаемом изменении качества обслуживания. Если базовый драйвер минипорта принимает измененные параметры вызова, cm затем вызывает NdisCmDispatchIncomingCallQoSChange.

Вызов NdisCmDispatchIncomingCallQoSChange вызывает функцию ProtocolClIncomingQoSChange клиента. Клиент принимает предлагаемые изменения параметров вызова для VC, не выполняя никаких действий, за исключением возможного обновления любого состояния, которое он поддерживает в отношении качества обслуживания для VC, и возврата управления. В противном случае клиент отклоняет предлагаемое изменение качества обслуживания, разрывая вызов.

Вызывать NdisCmDispatchIncomingCallQoSChange могут только автономные диспетчеры вызовов, которые регистрируют себя в NDIS в качестве драйверов протоколов. Драйверы мини-портов, ориентированные на подключение, которые обеспечивают встроенную поддержку управления звонками, вызывают вместо этого NdisMCmDispatchIncomingCallQoSChange .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisCmDispatchIncomingCallQoSChange (NDIS 5.1)) в Windows XP.
Целевая платформа	Персональный компьютер
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_CallManager_Function(ndis)