OID_NIC_SWITCH_VPORT_PARAMETERS

Articolo
06/15/2023

Un driver overlying può ottenere i parametri per una porta virtuale (VPort) in un commutatore di scheda di interfaccia di rete creato in una scheda di rete che supporta la virtualizzazione I/O radice singola (SR-IOV). Il driver invia una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_VPORT_PARAMETERS per ottenere questi parametri.

I driver overlying emettono una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS per impostare i parametri di configurazione di un VPort specificato collegato al commutatore NIC della scheda di rete. Queste richieste di set OID vengono inviate al driver miniport della funzione fisica PCI Express (PCIe) della scheda di rete. Queste richieste di set OID sono necessarie 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 a una struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Il driver overlying specifica il VPort per il metodo OID o imposta la richiesta impostando il membro VPortId della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS sull'identificatore associato a VPort. Il driver overlying ottiene l'identificatore VPort tramite uno dei modi seguenti:

Da una richiesta di metodo OID precedente di OID_NIC_SWITCH_CREATE_VPORT.
Da una richiesta di metodo OID precedente di OID_NIC_SWITCH_ENUM_VPORTS.

Commenti

OID_NIC_SWITCH_VPORT_PARAMETERS può essere usato nelle richieste del metodo OID o nelle richieste di set OID.

Gestione delle richieste di metodi OID di OID_NIC_SWITCH_VPORT_PARAMETERS

I driver overlying eseguono una richiesta di metodo OID di OID_NIC_SWITCH_VPORT_PARAMETERS per eseguire una query sui parametri di configurazione correnti di un VPort collegato al commutatore della scheda di rete della scheda di rete. I driver overlying specificano il VPort per eseguire una query impostando il membro VPortId della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS sull'identificatore VPort.

NDIS gestisce la richiesta del metodo OID di OID_NIC_SWITCH_VPORT_PARAMETERS per i driver miniport. NDIS restituisce informazioni ottenute dalle richieste OID precedenti di OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_ENUM_VPORTS.

Dopo aver restituito correttamente la richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS . Questa struttura contiene i parametri di configurazione per l'opzione specificata.

Per altre informazioni, vedere Esecuzione di query sui parametri di una porta virtuale.

Gestione delle richieste del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS

I driver overlying emettono una richiesta di set OID di OID_NIC_SWITCH_VPORT_PARAMETERS per modificare i parametri di configurazione correnti di un VPort collegato al commutatore della scheda di rete di una scheda di rete. Questa richiesta OID può essere usata per aggiornare i parametri per impostazione predefinita e per le VPort non predefinite.

È possibile modificare solo un subset limitato di parametri di configurazione per un VPort. Il driver overlying specifica il parametro da modificare impostando i membri seguenti della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS :

Il membro VPortId è impostato sull'identificatore del VPort i cui parametri verranno modificati.
I flag NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED appropriati vengono impostati nel membro Flags . I membri della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS possono essere modificati solo se un flag NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED corrispondente è definito in Ntddndis.h.
I membri corrispondenti della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS vengono impostati con i parametri di configurazione VPort da modificare.

Dopo che il driver miniport PF riceve la richiesta del set OID di OID_NIC_SWITCH_VPORT_PARAMETERS, il driver configura l'hardware con i parametri di configurazione. Il driver può modificare solo i parametri di configurazione identificati da NDIS_NIC_SWITCH_VPORT_PARAMETERS_Xxx_CHANGED flag nel membro Flags della struttura NDIS_NIC_SWITCH_VPORT_PARAMETERS .

Per altre informazioni, vedere Impostazione dei parametri di una porta virtuale.

Codici di stato restituiti

NDIS o il driver miniport PF restituisce il codice di stato seguente per le richieste OID set o method di OID_NIC_SWITCH_VPORT_PARAMETERS.

Codice di stato	Descrizione
NDIS_STATUS_SUCCESS	La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_NIC_SWITCH_CAPABILITIES.
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_VPORT_PARAMETERS hanno valori non validi.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni era troppo breve. NDIS o il driver miniport PF imposta i DATI. METHOD_INFORMATION. Membro BytesNeeded (per le richieste di metodo OID) o DATA. SET_INFORMATION. Membro BytesNeeded ( per le richieste di set OID) nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.