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)

Vedi anche


NDIS_NIC_SWITCH_DELETE_VPORT_PARAMETERS

NDIS_OID_REQUEST

NdisCloseAdapterEx

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_DELETE_SWITCH