Macro NdisMCmDispatchIncomingDropParty (ndis.h)
NdisMCmDispatchIncomingDropParty notifica um cliente de que ele deve remover uma parte específica em um 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 do 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 estiver NULL.
Valor de retorno
Nenhum
Observações
No curso 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 nível 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 multiponto estabelecida.
Uma chamada para NdisMCmDispatchIncomingDropParty faz com que o NDIS chame o cliente função ProtocolClIncomingDropParty.
Se o NdisPartyHandle identificar a última parte restante no VC determinado, o driver MCM chamará NdisMCmDispatchIncomingCloseCall, em vez de NdisMCmDispatchIncomingDropParty.
Somente drivers de miniporto orientados à conexão que fornecem suporte integrado ao gerenciamento de chamadas podem chamar NdisMCmDispatchIncomingDropParty. Os gerenciadores de chamadas autônomas, que se registram no NDIS como drivers de protocolo, chamam NdisCmDispatchIncomingDropParty em vez disso.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisMCmDispatchIncomingDropParty (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisMCmDispatchIncomingDropParty (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) |