Macro NdisMCmAddPartyComplete (ndis.h)

Artigo
02/07/2025

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

Sintaxe

void NdisMCmAddPartyComplete(
   _S_,
   _H_,
   _C_,
   _P_
);

Parâmetros

_S_

Especifica o status final da operação de suplemento do driver MCM, NDIS_STATUS_SUCCESS ou qualquer NDIS_STATUS_XXX, exceto NDIS_STATUS_PENDING.

_H_

Especifica o identificador que identifica a parte. O driver MCM obteve esse identificador como parâmetro de entrada para sua função ProtocolCmAddParty.

_C_

Especifica o identificador para uma área de contexto residente alocada pelo chamador na qual o driver MCM 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 poderá ser NULL porque ele será ignorado pelo NDIS se Status for diferente de NDIS_STATUS_SUCCESS.

_P_

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 a função ProtocolCmAddParty de um driver MCM retornar NDIS_STATUS_PENDING, o driver deverá chamar NdisMCmAddPartyComplete posteriormente 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 status de erro determinado pelo driver MCM.

O meio de rede subjacente determina se um cliente pode especificar parâmetros de tráfego por parte de uma VC de vários pontos.

Se o meio de rede subjacente não oferecer suporte a parâmetros de tráfego por parte de usuários em VCs de vários pontos, um driver MCM poderá fazer um dos seguintes sempre que um cliente tentar adicionar uma parte com uma especificação em CallParameters que não corresponda aos parâmetros de tráfego já estabelecidos para essa VC:

Redefina os parâmetros de tráfego para aqueles já estabelecidos para o VC de vários pontos quando ele adiciona com êxito a parte nessa VC.
Altere os parâmetros de tráfego para todas as partes já na VC quando ela adicionar a nova parte com êxito.
Rejeite a solicitação para adicionar uma nova 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 driver MCM definir Status para NDIS_STATUS_SUCCESS, ele deverá fornecer um identificador explícito, que geralmente é um ponteiro para a área de estado por parte alocada pelo driver, como CallMgrPartyContext quando chama NdisMCmAddPartyComplete.

Uma chamada para NdisMCmAddPartyComplete faz com que o NDIS chame o cliente função ProtocolClAddPartyComplete.

Somente drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmAddPartyComplete. Os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, chamam NdisCmAddPartyComplete.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmAddPartyComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmAddPartyComplete (NDIS 5.1)) no Windows XP.
da Plataforma de Destino	Área de trabalho
cabeçalho	ndis.h (inclua Ndis.h)
IRQL	<= DISPATCH_LEVEL
regras de conformidade de DDI	Irql_MCM_Function(ndis)