Condividi tramite


OID_NIC_SWITCH_PARAMETERS

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:

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:

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.

Requisiti

Versione

Supportato in NDIS 6.30 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedi anche


FilterAttach

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_NIC_SWITCH_PARAMETERS

NDIS_OID_REQUEST

OID_NIC_SWITCH_CREATE_SWITCH

OID_NIC_SWITCH_ENUM_SWITCHES

ProtocolBindAdapterEx