Função NdisCmDispatchIncomingCall (ndis.h)

Artigo
02/07/2025

NdisCmDispatchIncomingCall informa o cliente de uma chamada de entrada em um SAP registrado anteriormente por esse cliente.

Sintaxe

NDIS_STATUS NdisCmDispatchIncomingCall(
  [in] NDIS_HANDLE         NdisSapHandle,
  [in] NDIS_HANDLE         NdisVcHandle,
  [in] PCO_CALL_PARAMETERS CallParameters
);

Parâmetros

[in] NdisSapHandle

Especifica o identificador que identifica o SAP. O NDIS configurou esse identificador quando o cliente originalmente chamado NdisClRegisterSape o gerenciador de chamadas originalmente obteve esse identificador como um parâmetro de entrada para seu função ProtocolCmRegisterSap.

[in] NdisVcHandle

Especifica o identificador que identifica a VC, criada com NdisCoCreateVc quando o gerenciador de chamadas processa a oferta de chamada de entrada direcionada a esse SAP registrado.

[in] CallParameters

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

Valor de retorno

Quando NdisCmDispatchIncomingCall retorna qualquer coisa diferente de NDIS_STATUS_PENDING, o gerenciador de chamadas deve fazer uma chamada interna para sua função ProtocolCmIncomingCallComplete. Caso contrário, o NDIS chamará a função ProtocolCmIncomingCallComplete do CM quando essa operação for concluída.

Observações

Antes de chamar NdisCmDispatchIncomingCall, um gerenciador de chamadas autônomo 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 NdisCoCreateVc
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 NdisCmActivateVc, fazendo com que o driver de miniporto subjacente se preparasse para transferências na VC de acordo com os parâmetros de chamada negociados ou aceitos

A chamada do CM para NdisCmDispatchIncomingCall 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 o CM's função ProtocolCmIncomingCallComplete. Se o cliente aceitou a chamada, o cm em seguida chamará NdisCmDispatchCallConnected. 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 os gerentes de chamada autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmDispatchIncomingCall. Drivers de miniporto orientados para conexão que fornecem chamada de suporte integrado ao gerenciamento de chamadas NdisMCmDispatchIncomingCall.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmDispatchIncomingCall (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmDispatchIncomingCall (NDIS 5.1)) no Windows XP.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	Irql_CallManager_Function(ndis)