Macro NdisMCmDispatchIncomingCall (ndis.h)

Artigo
02/07/2025

NdisMCmDispatchIncomingCall informa o cliente de uma chamada de entrada em um SAP previamente registrado 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 NdisClRegisterSape o driver MCM obteve 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 a esse SAP registrado.

_CP_

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

Valor de retorno

Nenhum

Observações

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

Identificado o SAP de destino, anteriormente registrado 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 na 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 aceita 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) a 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 chamada de suporte integrado de gerenciamento de chamadas NdisMCmDispatchIncomingCall. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmDispatchIncomingCall.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	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.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	Irql_MCM_Function(ndis)