Funzione NdisMCmDeleteVc (ndis.h)

Articolo
08/07/2023

NdisMCmDeleteVc elimina un chiamante creato dal chiamante.

Sintassi

NDIS_STATUS NdisMCmDeleteVc(
  [in] NDIS_HANDLE NdisVcHandle
);

Parametri

[in] NdisVcHandle

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

Valore restituito

NdisMCmDeleteVc 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.

Commenti

Quando un driver MCM chiama NdisMCmDeleteVc, non devono essere presenti chiamate in sospeso sul vc specificato e che VC deve essere stato disattivato. Per soddisfare questi requisiti implica che il driver MCM ha già chiamato NdisMCmDeactivateVc con l'oggetto NdisVcHandle specificato correttamente.

Solo il driver che ha creato un determinato VC può eliminare tale VC. Una chiamata a NdisMCmDeleteVc causa la chiamata di NDIS alla funzione ProtocolCoDeleteVc del client con cui il chiamante condivide NdisVcHandle .

Quando NdisMCmDeleteVc restituisce il controllo, NdisVcHandle non è più valido. Il driver MCM può rilasciare le risorse allocate per mantenere lo stato relativo al VC eliminato o prepararli per il riutilizzo in una notifica di chiamata in ingresso successiva dopo che chiama NdisMCmCreateVc.

Il writer del driver determina se un driver MCM ha una funzione MiniportCoDeleteVc (interna) che il driver chiama nel contesto della riduzione delle connessioni per le chiamate in uscita e in ingresso.

Solo i driver miniport orientati alla connessione che forniscono supporto integrato per la gestione delle chiamate possono chiamare NdisMCmDeleteVc. I gestori di chiamate autonomi e i client, che si registrano con NDIS come driver di protocollo, chiamano invece NdisCoDeleteVc .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisMCmDeleteVc (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisMCmDeleteVc (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_MCM_Function(ndis)