Função NdisCmDispatchIncomingCall (ndis.h)

Artigo
08/07/2023

NdisCmDispatchIncomingCall informa ao 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 chamou NdisClRegisterSap e o gerenciador de chamadas obteve originalmente 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.

Retornar valor

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.

Comentários

Antes de chamar NdisCmDispatchIncomingCall, um gerenciador de chamadas autônomo 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 uma 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 deseja aceitar a conexão, o cliente chama NdisClIncomingCallComplete, que, por sua vez, chama os CM's Função ProtocolCmIncomingCallComplete . Se o cliente aceitou a chamada, o CM 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 chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmDispatchIncomingCall. Drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmDispatchIncomingCall .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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.
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)