Funzione NdisCoDeleteVc (ndis.h)

Articolo
02/29/2024

NdisCoDeleteVc elimina un chiamante creato da VC.

Sintassi

NDIS_STATUS NdisCoDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parametri

[in] NdisVcHandle

Specifica l'handle che identifica il VC da eliminare. Il chiamante ha originariamente ottenuto questo handle da NdisCoCreateVc.

Valore restituito

NdisCoDeleteVc può restituire uno dei seguenti elementi:

Codice restituito	Descrizione
NDIS_STATUS_SUCCESS	NDIS ha eliminato il VC.
NDIS_STATUS_NOT_ACCEPTED	Il vc è ancora attivo, quindi non è stato possibile eliminarlo.
NDIS_STATUS_CLOSING	Questa chiamata è ridondante, ma la disattivazione nel vc specificato è ancora in sospeso.

Commenti

Quando un protocollo chiama NdisCoDeleteVc, non vi devono essere chiamate in sospeso sul vc specificato e che VC è già stato disattivato. Per soddisfare questi requisiti implica che le condizioni seguenti contengano:

Se la chiamata è stata avviata da un client locale, tale client ha già chiamato NdisClCloseCall con l'oggetto NdisVcHandle specificato e la relativa richiesta di chiamata chiusa è stata completata correttamente.
Se la chiamata è stata avviata da un client remoto, il gestore chiamate autonomo ha già chiamato NdisCmDeactivateVc con l'oggetto NdisVcHandle specificato e la relativa richiesta di disattivazione è stata completata correttamente.

Solo il protocollo che ha creato un determinato VC può eliminare tale VC. Una chiamata a NdisCoDeleteVc fa sì che NDIS chiami sia la funzione miniport del driver sottostante MiniportCoDeleteVc che la funzione ProtocolCoDeleteVc del client o del chiamante con cui il chiamante condivide NdisVcHandle.

Quando NdisCoDeleteVc restituisce il controllo, NdisVcHandle non è più valido.

I responsabili delle chiamate autonomi, che si registrano con NDIS come driver di protocollo, possono chiamare NdisCoDeleteVc. Driver miniport orientati alla connessione che forniscono invece un supporto integrato per la gestione delle chiamate NdisMCmDeleteVc .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisCoDeleteVc (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisCoDeleteVc (NDIS 5.1) in Windows XP.
Piattaforma di destinazione	Desktop
Intestazione	ndis.h (includere Ndis.h)
Libreria	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regole di conformità DDI	Irql_Connection_Function(ndis)