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 parte 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 specifici del protocollo aggiuntivi ricevuti dalla parte remota, se presente. 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
Durante le normali operazioni di rete, un driver MCM chiama NdisMCmDispatchIncomingDropParty con 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 richiesta della 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 multipoint stabilita.
Una chiamata a NdisMCmDispatchIncomingDropParty causa la chiamata a NDIS Funzione ProtocolClIncomingDropParty .
Se 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 gestori di chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmDispatchIncomingDropParty .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmDispatchIncomingDropParty (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmDispatchIncomingDropParty (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (includere Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_MCM_Function(ndis) |