Funzione NdisCmCloseCallComplete (ndis.h)
NdisCmCloseCallComplete restituisce lo stato finale della richiesta di un client, per cui il gestore chiamate ha restituito in precedenza NDIS_STATUS_PENDING, per rimuovere una chiamata.
Sintassi
void NdisCmCloseCallComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE NdisVcHandle,
[in, optional] NDIS_HANDLE NdisPartyHandle
);
Parametri
[in] Status
Specifica lo stato finale della richiesta del client che il cm chiude la connessione, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXX determinato da CM, ad eccezione di NDIS_STATUS_PENDING.
[in] NdisVcHandle
Specifica l'handle per il vc per la chiamata. Questo handle è stato fornito da NDIS quando il vc è stato originariamente creato, indipendentemente dal gestore chiamate o dal client, con NdisCoCreateVc. Più di recente, il gestore chiamate ha ottenuto questo handle dal relativo stato per VC designato da CallMgrVcContext passato come parametro di input al relativo Funzione ProtocolCmCloseCall .
[in, optional] NdisPartyHandle
Specifica null se NdisVcHandle rappresenta un vc da punto a punto o l'handle all'ultima parte rimanente in una connessione multipunto, che il cm ottenuto dal relativo stato per parte designato da CallMgrPartyContext passato come parametro di input alla relativa funzione ProtocolCmCloseCall .
Valore restituito
nessuno
Osservazioni
Se la funzione ProtocolCmCloseCall di un gestore chiamate autonomo restituisce NDIS_STATUS_PENDING, cm deve chiamare NdisCmCloseCallComplete successivamente per notificare al client e all'NDIS che il tentativo di interruzione della connessione è stato completato, se correttamente o con un errore. Una chiamata a NdisCmCloseCallComplete fa sì che NDIS chiami il client Funzione ProtocolClCloseCallComplete .
Se passa NDIS_STATUS_SUCCESS come Stato, il gestore chiamate deve considerare NdisVcHandle (e NdisPartyHandle, se presente) inutilizzabile per i trasferimenti in rete non appena chiama NdisCmCloseCallComplete. Se il gestore chiamate ha originariamente creato il vc, deve chiamare NdisCoDeleteVc con lo stesso NdisVcHandle appena passato a NdisCmCloseCallComplete. Se il client ha creato questo vc, il gestore chiamate può aspettarsi una chiamata alla relativa funzione ProtocolCoDeleteVc con il
ProtocolVcContext, dove ha lo stesso NdisVcHandle, come parametro di input.
Solo i gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCmCloseCallComplete. Driver miniport orientati alla connessione che forniscono il supporto integrato per la gestione delle chiamate chiamano invece NdisMCmCloseCallComplete .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCmCloseCallComplete (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCmCloseCallComplete (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) |