Macro NdisMCmDispatchIncomingCall (ndis.h)

Artigo
08/07/2023

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 chamou NdisClRegisterSap e o driver MCM obteve esse identificador como um parâmetro de entrada para seu Função ProtocolCmRegisterSap .

_VH_

Especifica o identificador que identifica a VC, criada 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.

Retornar valor

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 recebeu pela rede
Criou uma 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 a 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 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 chamará 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 suporte integrado ao gerenciamento de chamadas chamam NdisMCmDispatchIncomingCall. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmDispatchIncomingCall .

Requisitos

Requisito	Valor
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	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
Regras de conformidade da DDI	Irql_MCM_Function(ndis)