Macro NdisMCmCloseCallComplete (ndis.h)

Articolo
08/07/2023

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)