функция обратного вызова PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE (ndis.h)

Статья
08/07/2023

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

Примечание Функцию необходимо объявить с помощью типа PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE . Дополнительные сведения см. в следующем разделе Примеры.

Синтаксис

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE ProtocolClIncomingCallQosChange;

void ProtocolClIncomingCallQosChange(
  [in] NDIS_HANDLE ProtocolVcContext,
  [in] PCO_CALL_PARAMETERS CallParameters
)
{...}

Параметры

[in] ProtocolVcContext

Указывает дескриптор области контекста клиента по каждому VC для VC, к которому по сети пришел запрос на изменение качества обслуживания.

[in] CallParameters

Указатель на буфер, отформатированный как CO_CALL_PARAMETERS структуру, которая содержит новую спецификацию качества обслуживания.

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

None

Remarks

Вызов ProtocolClIncomingCallQoSChange указывает клиенту, что удаленный одноранговый узел запросил изменение качества обслуживания при этом вызове. Новое качество обслуживания описано в разделе CallParameters . Клиент может принять запрошенные изменения, просто возвратив управление. Иначе
ProtocolClIncomingCallQoSChange должен разорвать вызов с помощью NdisClCloseCall.

Примеры

Чтобы определить функцию ProtocolClIncomingCallQoSChange , необходимо сначала предоставить объявление функции, определяющее тип определяемой функции. Windows предоставляет набор типов функций для драйверов. Объявление функции с помощью типов функций помогает анализу кода для драйверов, средству проверки статических драйверов (SDV) и другим средствам проверки находить ошибки, и это требование для написания драйверов для операционной системы Windows.

Например, чтобы определить функцию ProtocolClIncomingCallQoSChange с именем MyClIncomingCallQoSChange, используйте тип PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE , как показано в этом примере кода:

PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE MyClIncomingCallQoSChange;

Затем реализуйте функцию следующим образом:

_Use_decl_annotations_
VOID
 MyClIncomingCallQoSChange(
    NDIS_HANDLE  ProtocolVcContext,
    PCO_CALL_PARAMETERS  CallParameters
    )
  {...}

Тип функции PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE определен в файле заголовка Ndis.h. Чтобы более точно определить ошибки при запуске средств анализа кода, обязательно добавьте заметку Use_decl_annotations в определение функции. Заметка Use_decl_annotations гарантирует использование заметок, которые применяются к типу функции PROTOCOL_CL_INCOMING_CALL_QOS_CHANGE в файле заголовка. Дополнительные сведения о требованиях к объявлениям функций см. в разделе Объявление функций с помощью типов ролей функций для драйверов NDIS.

Сведения о Use_decl_annotations см. в статье О поведении функции.

Требования

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

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

NdisClCloseCall

NdisClModifyCallQoS

ProtocolCmModifyCallQoS

Поделиться через