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

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

Синтаксис

void NdisMCmDispatchIncomingCall(
  _SH_,
  _VH_,
  _CP_
);

Параметры

_SH_

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

_VH_

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

_CP_

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

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

Никакой

Замечания

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

  • Определен целевой SAP, ранее зарегистрированный конкретным клиентом, для вызова (фактически запроса на подключение), полученного по сети.
  • Создан VC для входящего вызова с NdisMCmCreateVc
  • Возможно, переговоры о допустимых параметрах вызова по сети или приняли параметры вызова, отправленные с удаленного узла.
  • Активировал VC с NdisMCmActivateVc, чтобы уведомить NDIS о том, что он готов к передаче в VC в соответствии с согласованными или принятыми параметрами вызова
Вызов драйвера MCM к NdisMCmDispatchIncomingCall вызывает NDIS для вызова функции ProtocolClIncomingCall, в которой клиент принимает или отклоняет запрошенные подключения. После принятия подключения клиент вызывает NdisClIncomingCallComplete, которая, в свою очередь, вызывает функцию драйвера MCM ProtocolCmIncomingCallComplete. Если клиент принял вызов, драйвер 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 (include Ndis.h)
IRQL <= DISPATCH_LEVEL
правил соответствия DDI Irql_MCM_Function(ndis)

См. также

CO_CALL_PARAMETERS

MiniportInterruptDPC

NdisClIncomingCallComplete

NdisClRegisterSap

NdisCmDispatchIncomingCall

NdisMCmActivateVc

NdisMCmCreateVc

NdisMCmDeactivateVc

NdisMCmDeleteVc

NdisMCmDispatchCallConnected

ProtocolClIncomingCall

ProtocolCmIncomingCallComplete

ProtocolCmRegisterSap

  • Last updated on