Funzione NdisMCmDeleteVc (ndis.h)
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 ha eliminato il VC. |
|
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) |