Macro NdisMCmDispatchIncomingCloseCall (ndis.h)
NdisMCmDispatchIncomingCloseCall indica a un client di rimuovere una chiamata attiva o offerta, in genere perché il driver MCM ha ricevuto una richiesta dalla rete per chiudere la connessione.
Sintassi
void NdisMCmDispatchIncomingCloseCall(
_S_,
_H_,
_B_,
_Z_
);
Parametri
_S_
Specifica un chiamante determinato NDIS_STATUS_XXX, che indica il motivo della richiesta di disconnessione. Durante le normali operazioni di rete, un driver MCM passa NDIS_STATUS_SUCCESS per indicare che ha ricevuto una richiesta, avviata dall'entità remota, per chiudere una chiamata attiva.
_H_
Specifica l'handle per il vc della chiamata disconnessa. Questo handle è stato fornito da NDIS quando è stato originariamente creato il vc, indipendentemente dal fatto che il driver MCM con NdisMCmCreateVc o come parametro di input per la relativa funzione ProtocolCoCreateVc.
_B_
Puntatore a un buffer residente allocato dal chiamante contenente altri dati di disconnessione specifici del protocollo, 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 NdisMCmDispatchIncomingCloseCall con il CloseStatus impostato su NDIS_STATUS_SUCCESS perché il client corrispondente nel nodo remoto ha chiamato NdisClCloseCall.
Tuttavia, un driver MCM può anche chiamare NdisMCmDispatchIncomingCloseCall se si verifica una delle condizioni seguenti:
- Il driver MCM ha informato un client di un'offerta di chiamata in arrivo. Quando il conducente del miniport ProtocolCmIncomingCallComplete funzione viene chiamata con l'accettazione del client, convalida i parametri di chiamata di input modificati dal client. ProtocolCmIncomingCallComplete determina che il client propone parametri di chiamata non supportati per la connessione, quindi chiama NdisMCmDispatchIncomingCloseCall.
- Condizioni di rete anomale forzano il driver MCM a rimuovere le chiamate attive. Ad esempio, se il driver MCM riceve una notifica quando un collegamento sulla connessione tra questo client e la parte remota della connessione si arresta, il driver miniport chiamerà NdisCmDispatchIncomingCloseCall per impedire al client di tentare (o prevedere) ulteriori trasferimenti di dati su una connessione interrotta.
Una chiamata a NdisMCmDispatchIncomingCloseCall fa sì che NDIS chiami il client funzione ProtocolClIncomingCloseCall.
Solo i driver miniport orientati alla connessione che forniscono supporto per la gestione delle chiamate possono chiamare NdisMCmDispatchIncomingCall. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano NdisCmDispatchIncomingCloseCall.