Макрос NdisMCmModifyCallQoSComplete (ndis.h)

Статья
02/29/2024

NdisMCmModifyCallQoSComplete указывает на завершение запроса клиента, для которого драйвер MCM ранее вернул NDIS_STATUS_PENDING, чтобы изменить качество обслуживания в VC.

Синтаксис

void NdisMCmModifyCallQoSComplete(
   _S_,
   _H_,
   _P_
);

Параметры

_S_

Указывает окончательное состояние запроса клиента на изменение качества обслуживания в этом VC либо NDIS_STATUS_SUCCESS, либо любой определяемой вызывающим NDIS_STATUS_XXX,за исключением NDIS_STATUS_PENDING.

_H_

Указывает дескриптор для VC, полученный из состояния per-VC, заданного callMgrVcContext , переданного драйверу MCM. Функция ProtocolCmModifyCallQoS для этого запроса.

_P_

Указатель на структуру типа CO_CALL_PARAMETERS указание QoS, приемлемого для драйвера MCM, если для параметра Status задано значение NDIS_STATUS_SUCCESS.

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

None

Remarks

Вызов NdisMCmModifyCallQoSComplete приводит к тому, что NDIS вызывает клиент Функция ProtocolClModifyCallQoSComplete .

Драйвер MCM должен вызывать NdisMCmActivateVc всякий раз, когда он вносит изменения в параметры вызова в активном VC.

Так как драйвер MCM может изменять предоставленные клиентом параметры вызова, которые были введены в его функцию ProtocolCmModifyCallQoS перед вызовом NdisMCmModifyCallQoSComplete, функция ProtocolClModifyCallQoSComplete клиента проверяет QoS, чтобы определить, является ли она приемлемой для клиента. ProtocolClModifyCallQoSComplete просто возвращает управление, если клиент принимает заданные параметры вызова. В противном случае клиент разрывает вызов.

Вызывать NdisMCmModifyCallQoSComplete могут только драйверы минипорта, ориентированные на подключение, которые обеспечивают встроенную поддержку управления звонками. Автономные диспетчеры вызовов, которые регистрируют себя с помощью NDIS в качестве драйверов протокола, вызывают вместо этого NdisCmModifyCallQoSComplete .

Требования

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