Funzione NdisCmDispatchIncomingDropParty (ndis.h)

  • Articolo

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 multipoint 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 l'entità 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 dall'entità 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 La funzione ProtocolCoReceiveNetBufferLists chiama NdisCmDispatchIncomingDropParty con CloseStatus impostato su NDIS_STATUS_SUCCESS perché un client remoto in una connessione multipoint ha chiamato NdisClCloseCall.

Tuttavia, un gestore chiamate può anche chiamare NdisCmDispatchIncomingDropParty con un CloseStatus determinato da CM, 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 NdisPartyHandle identifica l'ultima parte rimanente nel vc specificato, il cm chiama NdisCmDispatchIncomingCloseCall, anziché NdisCmDispatchIncomingDropParty.

Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmDispatchIncomingDropParty. Driver miniport orientati alla connessione che forniscono invece il supporto integrato per la gestione delle chiamate NdisMCmDispatchIncomingDropParty .

Requisiti

Requisito Valore
Client minimo supportato Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmDispatchIncomingDropParty (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmDispatchIncomingDropParty (NDIS 5.1)) in Windows XP.
Piattaforma di destinazione Desktop
Intestazione ndis.h (include Ndis.h)
Libreria Ndis.lib
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI Irql_CallManager_Function(ndis)

Vedi anche

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists