OID_NIC_SWITCH_DELETE_VPORT
Un driver overlying rilascia una richiesta di set di identificatori di oggetto (OID) di OID_NIC_SWITCH_DELETE_VPORT per eliminare una porta virtuale non predefinita (VPort) creata in precedenza nel commutatore di scheda di rete di una scheda di rete. Il driver overlying può eliminare un VPort creato in precedenza solo inviando una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
I driver eccessivamente rilasciano questa richiesta OID set al driver miniport per la funzione fisica PCIe (PF) della scheda di rete. Questa richiesta di set OID è necessaria per i driver miniport PF che supportano l'interfaccia SR-IOV (Single Root I/O Virtualization).
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore alla struttura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS .
Commenti
Un driver eccessivamente predefinito, ad esempio un protocollo o un driver di filtro, può eliminare solo un VPort non predefinito creato in precedenza. Il driver overlying crea un VPort inviando una richiesta di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.
Quando il driver miniport PF riceve la richiesta OID di OID_NIC_SWITCH_DELETE_VPORT, il driver deve liberare le risorse hardware e software allocate per il VPort specificato.
Per altre informazioni, vedere Eliminazione di una porta virtuale.
Nota Solo le VPort non predefinite possono essere eliminate in modo esplicito tramite richieste OID di OID_NIC_SWITCH_DELETE_VPORT. Il VPort predefinito viene eliminato in modo implicito quando il driver miniport PF elimina l'opzione di interfaccia di rete predefinita. Per altre informazioni, vedere Eliminazione di un commutatore di scheda di interfaccia di rete.
Codici di stato restituiti
Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta di set OID di OID_NIC_SWITCH_DELETE_VPORT.
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta OID è stata completata correttamente. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport PF non supporta l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) o non è abilitata per l'uso dell'interfaccia. |
NDIS_STATUS_INVALID_PARAMETER |
Uno o più membri della struttura NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS hanno valori non validi. |
NDIS_STATUS_INVALID_LENGTH |
La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS). Il driver miniport PF deve impostare i DATI. SET_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie. |
NDIS_STATUS_FAILURE |
La richiesta non è riuscita per altri motivi. |
Requisiti
Versione |
Supportato in NDIS 6.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |