Função NdisCmAddPartyComplete (ndis.h)
NdisCmAddPartyComplete retorna o 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 um VC multiponto estabelecido.
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, 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 de 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 ele é 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.
Valor de retorno
Nenhum
Observações
Se uma função protocolCmAddParty do 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 no 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 o 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 o 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 o VC e, para todas as partes atualmente conectadas a ele, 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 um 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 multipoint especificado.)
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 gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmAddPartyComplete. Drivers de miniporto orientados para conexão que fornecem chamada de suporte integrado ao gerenciamento de chamadas NdisMCmAddPartyComplete.