Função NdisClMakeCall (ndis.h)

Artigo
08/07/2023

NdisClMakeCall configura uma chamada de saída em uma VC criada pelo cliente.

Sintaxe

NDIS_STATUS NdisClMakeCall(
  [in]            NDIS_HANDLE         NdisVcHandle,
  [in, out]       PCO_CALL_PARAMETERS CallParameters,
  [in, optional]  NDIS_HANDLE         ProtocolPartyContext,
  [out, optional] PNDIS_HANDLE        NdisPartyHandle
);

Parâmetros

[in] NdisVcHandle

Especifica o identificador retornado por uma chamada anterior para NdisCoCreateVc.

[in, out] CallParameters

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS em que o chamador especificou os atributos para essa conexão, como o endereço do destino para a chamada, latência, largura de banda e qualidade de serviço se a família de endereços e mídia de rede com suporte do gerenciador de chamadas permitir especificações de QoS.

[in, optional] ProtocolPartyContext

Opcionalmente, especifica um identificador fornecido pelo chamador para uma área de contexto residente na qual o cliente manterá o estado por parte da parte inicial em sua VC de vários pontos. Esse parâmetro será NULL se a VC fornecida não representar uma conexão de vários pontos. Para uma VC de vários pontos, o NDIS passa esse identificador de volta para as funções ProtocolClXxx do cliente em todas as chamadas subsequentes que afetam essa parte específica.

[out, optional] NdisPartyHandle

Ponteiro para uma variável fornecida pelo chamador, geralmente na área de contexto de parte alocada pelo chamador, na qual o NDIS retorna um identificador que representa a parte inicial para a conexão de vários pontos se a solicitação para configurar uma chamada de saída for bem-sucedida. Se ProtocolPartyContext for NULL, essa variável, geralmente na área de contexto vc do cliente, também será definida como NULL após a conclusão da configuração de chamada de saída.

Retornar valor

Quando NdisClMakeCall retorna algo diferente de NDIS_STATUS_PENDING, o cliente deve fazer uma chamada interna para sua Função ProtocolClMakeCallComplete . Caso contrário, o NDIS chamará a função ProtocolClMakeCallComplete do cliente quando essa operação for concluída.

Comentários

NdisClMakeCall configura os atributos de uma VC criada pelo cliente para uma chamada de saída iniciada pelo cliente. O cliente deve configurar a VC com NdisCoCreateVc antes de tentar fazer uma chamada de saída.

Uma chamada para NdisClMakeCall faz com que o NDIS encaminhe essa solicitação para a função ProtocolCmMakeCall do gerenciador de chamadas com a qual o cliente compartilha o NdisVcHandle fornecido. O CM é responsável por validar os dados determinados em CallParameters . Ele pode modificar esses dados fornecidos pelo cliente durante a negociação com componentes de rede relevantes e pode retornar parâmetros de tráfego diferentes do cliente originalmente fornecido ao NdisClMakeCall. O do clienteA função ProtocolClMakeCallComplete é responsável por aceitar os parâmetros de chamada modificados se isso ocorrer ou para derrubar a chamada se os parâmetros de chamada propostos pelo CM forem inaceitáveis.

Consequentemente, os dados em CallParameters devem permanecer disponíveis para o gerenciador de chamadas pelo menos durante a configuração da chamada. O cliente não pode liberar esse buffer quando NdisClMakeCall retorna NDIS_STATUS_PENDING. Ele deve adiar a liberação desse recurso alocado pelo cliente até que sua função ProtocolClMakeCallComplete seja chamada.

Se NdisClMakeCall configurar uma conexão de vários pontos, o cliente estabelecerá os parâmetros de tráfego globalmente para a VC especificada, a menos que a mídia de rede subjacente dê suporte a parâmetros de tráfego por parte.

A função ProtocolClMakeCallComplete do cliente deve marcar o Status de entrada para NDIS_STATUS_SUCCESS antes de usar qualquer identificador retornado em NdisPartyHandle . Se o gerenciador de chamadas falhar na solicitação para configurar uma chamada em uma conexão de vários pontos, o valor dessa variável fornecida pelo cliente será inválido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisClMakeCall (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisClMakeCall (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 da DDI	Irql_Protocol_Driver_Function(ndis)