Macro NdisMCmDispatchIncomingDropParty (ndis.h)
NdisMCmDispatchIncomingDropParty notifica a un client che deve rimuovere una determinata parte in un vc multipoint.
Sintassi
void NdisMCmDispatchIncomingDropParty(
_S_,
_H_,
_B_,
_Z_
);
Parametri
_S_
Indica il motivo per cui questa entità viene eliminata, in genere NDIS_STATUS_SUCCESS se la parte remota ha semplicemente richiesto che la connessione venga chiusa.
_H_
Specifica l'handle che identifica la parte da eliminare dal vc multipoint, che deve avere altre parti ancora connesse. Il driver MCM ha originariamente ottenuto questo handle come parametro di input per la relativa funzione ProtocolCmAddParty.
_B_
Puntatore a un buffer residente allocato dal chiamante contenente dati aggiuntivi specifici del protocollo ricevuti dalla parte remota, se presenti. A seconda del supporto sottostante, questo puntatore può essere NULL.
_Z_
Specifica le dimensioni in byte del buffer, zero se buffer è NULL.
Valore restituito
Nessuno
Osservazioni
Nel corso delle normali operazioni di rete, un driver MCM chiama NdisMCmDispatchIncomingDropParty con il CloseStatus impostato su NDIS_STATUS_SUCCESS perché un client remoto in una connessione multipoint ha chiamato NdisClCloseCall.
Tuttavia, un driver MCM può anche chiamare NdisMCmDispatchIncomingDropParty con un driver determinato CloseStatus alla rete stessa se si verificano condizioni di rete anomale, ad esempio l'errore di un commutatore sul percorso tra il client locale e uno o più client in una connessione multipunto stabilita.
Una chiamata a NdisMCmDispatchIncomingDropParty fa sì che NDIS chiami il client funzione ProtocolClIncomingDropParty.
Se il NdisPartyHandle identifica l'ultima parte rimanente nel vc specificato, il driver MCM chiama NdisMCmDispatchIncomingCloseCall, anziché NdisMCmDispatchIncomingDropParty.
Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmDispatchIncomingDropParty. I responsabili delle chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmDispatchIncomingDropParty.