Macro NdisMCmCloseCallComplete (ndis.h)
NdisMCmCloseCallComplete restituisce lo stato finale della richiesta di un client, per cui il driver MCM ha restituito in precedenza NDIS_STATUS_PENDING, per abbattere 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 chiamante determinato NDIS_STATUS_XXX tranne 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 il NdisVcHandle rappresenta un vc da punto a punto o l'handle dell'ultima parte rimanente in una connessione multipunto, ottenuto dal driver MCM ottenuto dal relativo stato per parti designato dal CallMgrPartyContext passato come parametro di input al relativo stato per parti 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 NDIS che il tentativo di interrompere la connessione è stato completato, sia che abbia esito positivo o con un errore. Una chiamata a NdisMCmCloseCallComplete fa sì che NDIS chiami la funzione ProtocolClCloseCallComplete del client.
Se passa NDIS_STATUS_SUCCESS come Status, il driver MCM deve considerare l'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ò aspettarsi una chiamata alla relativa funzione ProtocolCoDeleteVc con la funzione
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.