Macro NdisMCmDispatchIncomingDropParty (ndis.h)

  • Articolo

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)

Vedi anche

MiniportInterruptDPC

NdisClDropParty

NdisCmDispatchIncomingDropParty NdisMCmDispatchIncomingCloseCall

ProtocolClIncomingDropParty