Macro NdisMCmDispatchIncomingDropParty (ndis.h)

NdisMCmDispatchIncomingDropParty notifica um cliente de que ele deve remover uma parte específica em uma VC de vários pontos.

Sintaxe

void NdisMCmDispatchIncomingDropParty(
   _S_,
   _H_,
   _B_,
   _Z_
);

Parâmetros

_S_

Indica o motivo pelo qual essa parte está sendo descartada, geralmente NDIS_STATUS_SUCCESS se a parte remota simplesmente solicitou que sua conexão fosse fechada.

_H_

Especifica o identificador que identifica a parte a ser removida da VC de vários pontos, que deve ter outras partes que ainda estão conectadas. O driver MCM obteve originalmente esse identificador como um parâmetro de entrada para sua função ProtocolCmAddParty .

_B_

Ponteiro para um buffer residente alocado pelo chamador que contém dados adicionais específicos do protocolo recebidos da parte remota, se houver. Dependendo do meio subjacente, esse ponteiro pode ser NULL.

_Z_

Especifica o tamanho em bytes do buffer, zero se Buffer for NULL.

Retornar valor

Nenhum

Comentários

No decorrer de operações de rede normais, um driver MCM chama NdisMCmDispatchIncomingDropParty com o CloseStatus definido como NDIS_STATUS_SUCCESS porque um cliente remoto em uma conexão de vários pontos chamou NdisClCloseCall.

No entanto, um driver MCM também pode chamar NdisMCmDispatchIncomingDropParty com um CloseStatus determinado pelo driver a responsabilidade da própria rede se ocorrerem condições anormais de rede, como a falha de um comutador no caminho entre o cliente local e um ou mais clientes em uma conexão multipoint estabelecida.

Uma chamada para NdisMCmDispatchIncomingDropParty faz com que o NDIS chame o cliente Função ProtocolClIncomingDropParty .

Se o NdisPartyHandle identificar a última parte restante na VC fornecida, o driver MCM chamará NdisMCmDispatchIncomingCloseCall, em vez de NdisMCmDispatchIncomingDropParty.

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

Requisitos

Confira também

MiniportInterruptDPC

NdisClDropParty

ProtocolClIncomingDropParty