Função NdisCmAddPartyComplete (ndis.h)

Artigo
08/07/2023

NdisCmAddPartyComplete retorna a status final da solicitação de um cliente, para a qual o gerenciador de chamadas retornou anteriormente NDIS_STATUS_PENDING, para adicionar uma parte em uma VC de vários pontos estabelecida.

Sintaxe

void NdisCmAddPartyComplete(
  [in]           NDIS_STATUS         Status,
  [in]           NDIS_HANDLE         NdisPartyHandle,
  [in, optional] NDIS_HANDLE         CallMgrPartyContext,
  [in]           PCO_CALL_PARAMETERS CallParameters
);

Parâmetros

[in] Status

Especifica o status final da operação de suplemento do gerenciador de chamadas, seja NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_XXX, exceto NDIS_STATUS_PENDING.

[in] NdisPartyHandle

Especifica o identificador que identifica a parte. Esse identificador foi inserido na função ProtocolCmAddParty do gerenciador de chamadas.

[in, optional] CallMgrPartyContext

Especifica o identificador para uma área de contexto residente alocada pelo chamador na qual o gerenciador de chamadas manterá informações de estado específicas da parte se a operação de suplemento tiver sido bem-sucedida. Caso contrário, esse parâmetro pode ser NULL porque é ignorado.

[in] CallParameters

Ponteiro para uma estrutura do tipo CO_CALL_PARAMETERS que contém os parâmetros de chamada, originalmente fornecidos pelo cliente, para que a parte seja adicionada.

Retornar valor

Nenhum

Comentários

Se a função ProtocolCmAddParty de um gerenciador de chamadas autônoma retornar NDIS_STATUS_PENDING, o CM deverá chamar NdisCmAddPartyComplete para notificar o cliente e o NDIS de que sua tentativa de adicionar uma parte na VC de vários pontos foi concluída, seja com êxito ou com um erro.

Se o cliente passou parâmetros de tráfego em CallParameters que não correspondam aos já estabelecidos para a VC de vários pontos, o designer do gerenciador de chamadas deverá determinar como lidar com essa condição, sujeito a quaisquer restrições impostas pelo meio de rede. As possibilidades incluem o seguinte:

Configure os parâmetros de tráfego por parte se o meio de rede subjacente der suporte a esse recurso em VCs de vários pontos.
Redefina os parâmetros de tráfego fornecidos pelo cliente para aqueles estabelecidos para a VC quando a chamada de saída original foi feita antes que o CM chame NdisCmAddPartyComplete com NDIS_STATUS_SUCCESS como o Status .
Altere os parâmetros de tráfego para a VC e, para cada parte conectada atualmente nele, para os valores fornecidos pelo cliente antes que o CM chame NdisCmAddPartyComplete com NDIS_STATUS_SUCCESS como o Status .
Falha na tentativa do cliente de adicionar uma parte. (Essa alternativa força implicitamente os clientes a configurar seus parâmetros de tráfego para uma VC de vários pontos com NdisClMakeCall e especificar os mesmos parâmetros de tráfego em cada chamada subsequente para NdisClAddParty para o VC de vários pontos fornecidos.)

Para algumas mídias orientadas a conexão, os parâmetros de tráfego são por VC por natureza e, consequentemente, idênticos para todas as partes em uma VC de vários pontos.

Se o CM definir Status como NDIS_STATUS_SUCCESS, ele deverá fornecer um identificador explícito, que geralmente é um ponteiro para a área de estado por parte alocada por CM, como CallMgrPartyContext quando chama NdisCmAddPartyComplete.

Uma chamada para NdisCmAddPartyComplete faz com que o NDIS chame o cliente Função ProtocolClAddPartyComplete .

Somente os gerentes de chamadas autônomos, que se registram com o NDIS como drivers de protocolo, podem chamar NdisCmAddPartyComplete. Drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmAddPartyComplete .

Requisitos

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