Macro NdisMCmDispatchIncomingCall (ndis.h)

NdisMCmDispatchIncomingCall informa ao cliente de uma chamada de entrada em um SAP registrado anteriormente por esse cliente com o driver MCM.

Sintaxe

void NdisMCmDispatchIncomingCall(
   _SH_,
   _VH_,
   _CP_
);

Parâmetros

_SH_

Especifica o identificador que identifica o SAP. O NDIS configurou esse identificador quando o cliente originalmente chamado NdisClRegisterSap e o driver MCM obtiveram esse identificador como um parâmetro de entrada para seu Função ProtocolCmRegisterSap .

_VH_

Especifica o identificador que identifica o VC, criado com NdisMCmCreateVc quando o driver MCM processa a oferta de chamada de entrada direcionada para esse SAP registrado.

_CP_

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS que especifica os parâmetros de chamada e mídia para o VC.

Valor retornado

Nenhum

Comentários

Antes de chamar NdisMCmDispatchIncomingCall, um driver MCM já fez o seguinte:

  • Identificado o SAP de destino, registrado anteriormente por um cliente específico, para a chamada (na verdade, uma solicitação para fazer uma conexão) que ele recebeu pela rede
  • Criou um VC para a chamada de entrada com NdisMCmCreateVc
  • Possivelmente negociado sobre parâmetros de chamada aceitáveis pela rede ou aceitou os parâmetros de chamada enviados do nó remoto
  • Ativou o VC com NdisMCmActivateVc para notificar o NDIS de que ele está pronto para transferências no VC de acordo com os parâmetros de chamada negociados ou aceitos
A chamada do driver MCM para NdisMCmDispatchIncomingCall faz com que o NDIS chame a função ProtocolClIncomingCall do cliente, na qual o cliente aceita ou rejeita a conexão solicitada. Depois de decidir se deseja aceitar a conexão, o cliente chama NdisClIncomingCallComplete, que, por sua vez, chama a função ProtocolCmIncomingCallComplete do driver MCM. Se o cliente aceitou a chamada, o driver MCM próximas chamadas NdisMCmDispatchCallConnected. Caso contrário, ele desativa (e possivelmente exclui) o VC que criou, depois de notificar o nó remoto de que a chamada oferecida foi rejeitada.

Somente drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmDispatchIncomingCall. Os gerentes de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmDispatchIncomingCall .

Requisitos

   
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmDispatchIncomingCall (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmDispatchIncomingCall (NDIS 5.1)) no Windows XP.
Plataforma de Destino Desktop
Cabeçalho ndis.h (inclua Ndis.h)
IRQL <= DISPATCH_LEVEL
Regras de conformidade DDI Irql_MCM_Function(ndis)

Confira também

CO_CALL_PARAMETERS

MiniportInterruptDPC

NdisClIncomingCallComplete

NdisClRegisterSap

NdisCmDispatchIncomingCall

NdisMCmActivateVc

NdisMCmCreateVc

NdisMCmDeactivateVc

NdisMCmDeleteVc

NdisMCmDispatchCallConnected

ProtocolClIncomingCall

ProtocolCmIncomingCallComplete

ProtocolCmRegisterSap