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

Статья
08/07/2023

NdisMCmDispatchIncomingCall информирует клиента о входящем вызове в SAP, ранее зарегистрированном этим клиентом с помощью драйвера MCM.

Синтаксис

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Параметры

_SH_

Указывает дескриптор, идентифицирующий SAP. NDIS настраивает этот дескриптор, когда клиент изначально назывался NdisClRegisterSap, а драйвер MCM получил этот дескриптор в качестве входного параметра для его Функция ProtocolCmRegisterSap .

_VH_

Указывает дескриптор, идентифицирующий VC, созданный с помощью NdisMCmCreateVc , когда драйвер MCM обрабатывает входящее предложение вызова, направленное в зарегистрированный SAP.

_CP_

Указатель на структуру типа CO_CALL_PARAMETERS , указывающую параметры вызова и носителя для VC.

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

None

Remarks

Перед вызовом NdisMCmDispatchIncomingCall драйвер MCM уже выполнил следующие действия:

Определен целевой SAP, ранее зарегистрированный определенным клиентом, для вызова (фактически запроса на подключение), полученного по сети.
Создан VC для входящего вызова с помощью NdisMCmCreateVc
Возможно, согласованы допустимые параметры вызова по сети или приняты параметры вызова, отправленные с удаленного узла
Активировал VC с помощью NdisMCmActivateVc , чтобы уведомить NDIS о том, что он готов к передаче в VC в соответствии с согласованными или принятыми параметрами вызова.

Вызов драйвера MCM к NdisMCmDispatchIncomingCall приводит к тому, что NDIS вызывает функцию ProtocolClIncomingCall клиента, в рамках которой клиент принимает или отклоняет запрошенные подключения. После принятия решения о приеме подключения клиент вызывает NdisClIncomingCallComplete, который, в свою очередь, вызывает функцию ProtocolCmIncomingCallComplete драйвера MCM. Если клиент принял вызов, драйвер MCM далее вызывает NdisMCmDispatchCallConnected. В противном случае он отключает (и, возможно, удаляет) созданный им VC после уведомления удаленного узла о том, что предложенный вызов отклонен.

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

Требования

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