Funzione NdisCmDispatchIncomingDropParty (ndis.h)
NdisCmDispatchIncomingDropParty notifica a un client che deve rimuovere una determinata parte in un vc multipoint, in genere perché il gestore chiamate ha ricevuto una richiesta in rete per chiudere una connessione multipunto attiva.
Sintassi
void NdisCmDispatchIncomingDropParty(
[in] NDIS_STATUS DropStatus,
[in] NDIS_HANDLE NdisPartyHandle,
[in, optional] PVOID Buffer,
[in] UINT Size
);
Parametri
[in] DropStatus
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.
[in] NdisPartyHandle
Specifica l'handle che identifica la parte da eliminare dal vc multipoint, che deve avere altre parti ancora connesse.
[in, optional] Buffer
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.
[in] Size
Specifica le dimensioni in byte del buffer, zero se buffer è NULL.
Valore restituito
Nessuno
Osservazioni
Nel corso delle normali operazioni di rete, un gestore chiamate autonomo ProtocolCoReceiveNetBufferLists le chiamate di funzione NdisCmDispatchIncomingDropParty con il CloseStatus impostato su NDIS_STATUS_SUCCESS perché un client remoto in una connessione multipunto ha chiamato NdisClCloseCall.
Tuttavia, un gestore chiamate può anche chiamare NdisCmDispatchIncomingDropParty con un determinato da CM 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 multipunto stabilita.
Una chiamata a NdisCmDispatchIncomingDropParty fa sì che NDIS chiami il client funzione ProtocolClIncomingDropParty.
Se il NdisPartyHandle identifica l'ultima parte rimanente nel vc specificato, il cm chiama NdisCmDispatchIncomingCloseCallanziché NdisCmDispatchIncomingDropParty.
Solo i responsabili delle chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmDispatchIncomingDropParty. Driver miniport orientati alla connessione che forniscono invece una chiamata integrata di gestione delle chiamate NdisMCmDispatchIncomingDropParty.