Macro NdisMCmAddPartyComplete (ndis.h)

Artigo
02/29/2024

NdisMCmAddPartyComplete retorna a 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 for bem-sucedida. Caso contrário, esse parâmetro poderá ser NULL porque ele será ignorado pelo NDIS se Status for algo 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.

Retornar valor

Nenhum

Comentários

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 na VC de vários pontos foi concluída, seja com êxito ou com um erro determinado pelo driver MCM status.

O meio de rede subjacente determina se um cliente pode especificar parâmetros de tráfego por parte em 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 procedimentos 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 a VC de vários pontos quando ele adicionar com êxito a parte nessa VC.
Altere os parâmetros de tráfego para cada parte 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 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 driver MCM 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 pelo driver, como CallMgrPartyContext quando chama NdisMCmAddPartyComplete.

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

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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.
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)