Função NdisCmAddPartyComplete (ndis.h)
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.)
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) |