OID_NIC_SWITCH_PARAMETERS

Articolo
06/15/2023

Un driver che esegue eccessivamente una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_PARAMETERS per ottenere i parametri di configurazione correnti di un commutatore di interfaccia di rete specificato in una scheda di rete. NDIS gestisce queste richieste di metodo OID per il driver miniport.

I driver overlying emettono una richiesta di set OID di OID_NIC_SWITCH_PARAMETERS per impostare i parametri di configurazione di un commutatore di interfaccia di rete specificato su una 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_PARAMETERS .

Il driver che esegue l'overlying specifica l'opzione NIC per il metodo OID o imposta la richiesta impostando il membro SwitchId della struttura NDIS_NIC_SWITCH_PARAMETERS sull'identificatore del commutatore. Il driver overlying ottiene l'identificatore del commutatore tramite uno dei modi seguenti:

Da una precedente richiesta di metodo OID di OID_NIC_SWITCH_ENUM_SWITCHES.
Dal membro NicSwitchArray della struttura NDIS_BIND_PARAMETERS . NDIS passa un puntatore a questa struttura nel parametro BindParameters della funzione ProtocolBindAdapterEx .
Dal membro NicSwitchArray della struttura NDIS_FILTER_ATTACH_PARAMETERS . NDIS passa un puntatore a questa struttura nel parametro AttachParameters della funzione FilterAttach .

Nota A partire da Windows Server 2012, Windows supporta solo il commutatore di scheda di interfaccia di rete predefinito nella scheda di rete. Il membro SwitchId della struttura NDIS_NIC_SWITCH_PARAMETERS deve essere impostato su NDIS_DEFAULT_SWITCH_ID.

Commenti

Il driver eccessivamente emette OID_NIC_SWITCH_PARAMETERS richieste nel modo seguente:

Il driver overlying invia una richiesta di metodo OID di OID_NIC_SWITCH_PARAMETERS per ottenere i parametri correnti di un'opzione di interfaccia di rete specificata. Per altre informazioni, vedere Esecuzione di query sui parametri di un commutatore di scheda di interfaccia di rete.

Nota NDIS gestisce le richieste di metodi OID di OID_NIC_SWITCH_PARAMETERS per il driver miniport PF.
Il driver overlying invia una richiesta di set OID di OID_NIC_SWITCH_PARAMETERS per modificare i parametri correnti di un'opzione di interfaccia di rete specificata. Per altre informazioni, vedere Impostazione dei parametri di un commutatore di scheda di interfaccia di rete.

Nota Il driver miniport PF gestisce le richieste set OID di OID_NIC_SWITCH_PARAMETERS.

Codici di stato restituiti

NDIS o il driver miniport PF restituisce i codici di stato seguenti per le richieste OID set o method di OID_NIC_SWITCH_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_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_REINIT_REQUIRED	Il driver miniport PF richiede una reinizializzazione della scheda di rete per applicare le modifiche al commutatore della scheda di interfaccia di rete.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.