Macro NdisMCmCloseCallComplete (ndis.h)
NdisMCmCloseCallComplete restituisce lo stato finale della richiesta di un client, per cui il driver MCM restituito in precedenza NDIS_STATUS_PENDING, per rimuovere una chiamata.
Sintassi
void NdisMCmCloseCallComplete(
_S_,
_VH_,
_PH_
);
Parametri
_S_
Specifica lo stato finale della richiesta del client che il driver MCM chiude la connessione, NDIS_STATUS_SUCCESS o qualsiasi NDIS_STATUS_XXX determinato dal chiamante, ad eccezione di NDIS_STATUS_PENDING.
_VH_
Specifica l'handle per il vc per la chiamata. 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 .
_PH_
Specifica null se NdisVcHandle rappresenta un vc da punto a punto o l'handle all'ultima parte rimanente in una connessione multipoint, che il driver MCM ottenuto dal relativo stato per parte designato da CallMgrPartyContext passato come parametro di input al relativo Funzione ProtocolCmCloseCall .
Valore restituito
nessuno
Osservazioni
Se la funzione ProtocolCmCloseCall di un driver MCM restituisce NDIS_STATUS_PENDING, deve chiamare NdisMCmCloseCallComplete successivamente per notificare al client e al NDIS che il tentativo di interruzione della connessione è stato completato, se correttamente o con un errore. Una chiamata a NdisMCmCloseCallComplete fa sì che NDIS chiami la funzione ProtocolClCloseCallComplete del client.
Se passa NDIS_STATUS_SUCCESS come Stato, il driver MCM deve considerare NdisVcHandle (e NdisPartyHandle, se presente) inutilizzabile per i trasferimenti in rete non appena chiama NdisMCmCloseCallComplete. Se il driver MCM ha originariamente creato il vc, deve chiamare NdisMCmDeleteVc con lo stesso NdisVcHandle appena passato a NdisMCmCloseCallComplete. Se il client ha creato questo vc, il driver MCM può prevedere una chiamata alla relativa funzione ProtocolCoDeleteVc con il
ProtocolVcContext, designando lo stato per vc in cui è archiviato lo stesso NdisVcHandle, come parametro di input.
Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmCloseCallComplete. I gestori chiamate autonomi, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCmCloseCallComplete .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmCloseCallComplete (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmCloseCallComplete (NDIS 5.1)) in Windows XP. |
| Piattaforma di destinazione | Desktop |
| Intestazione | ndis.h (include Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_MCM_Function(ndis) |