Condividi tramite

Impostazione dei parametri di un commutatore di interfaccia di rete

  • Articolo

Un driver overlying può modificare i parametri per un commutatore di interfaccia di interfaccia di rete creato in una scheda di rete che supporta la virtualizzazione I/O radice singola (SR-IOV). Il driver genera una richiesta di set OID (Object Identifier) di OID_NIC_SWITCH_PARAMETERS per modificare questi parametri. Solo il driver miniport per la funzione fisica PCI Express (PCIe) dell'adattatore SR-IOV gestisce questa richiesta di set OID.

Prima che il driver overlying problemi questa richiesta del set OID, deve inizializzare una struttura NDIS_NIC_SWITCH_PARAMETERS con i parametri da modificare nel commutatore di interfaccia di interfaccia di rete. Il driver inizializza quindi una struttura NDIS_OID_REQUEST per la richiesta OID e imposta il membro InformationBuffer su un puntatore della struttura NDIS_NIC_SWITCH_PARAMETERS .

È possibile modificare solo un subset limitato di parametri di configurazione per un commutatore della scheda di interfaccia di rete. Il driver overlying specifica il parametro da modificare impostando i membri seguenti della struttura NDIS_NIC_SWITCH_PARAMETERS :

  • Il membro SwitchId è impostato sull'identificatore dell'opzione di interfaccia di interfaccia di rete i cui parametri verranno modificati.

    Nota A partire da Windows Server 2012, l'interfaccia SR-IOV supporta un solo commutatore della scheda di rete nella scheda di rete. Questo commutatore è noto come commutatore di interfaccia di interfaccia di rete predefinito. Il membro SwitchId deve essere impostato su NDIS_DEFAULT_SWITCH_ID.

  • I flag NDIS_NIC_SWITCH_PARAMETERS_Xxx appropriati_CHANGED sono impostati nel membro Flags . I membri della struttura NDIS_NIC_SWITCH_PARAMETERS possono essere modificati solo se un flag di NDIS_NIC_SWITCH_PARAMETERS_Xxx corrispondente_CHANGED è definito in Ntddndis.h.

  • I membri della struttura NDIS_NIC_SWITCH_PARAMETERS , che corrispondono ai flag NDIS_NIC_SWITCH_PARAMETERS_Xxx_CHANGED impostati nel membro Flags , vengono impostati con i parametri di configurazione del commutatore di interfaccia di rete da modificare.

    Nota A partire da Windows Server 2012, è possibile modificare solo il membro SwitchName della struttura NDIS_NIC_SWITCH_PARAMETERS tramite una richiesta OID set di OID_NIC_SWITCH_PARAMETERS.

Il driver miniport PF deve seguire queste linee guida quando riceve la richiesta del set OID di OID_NIC_SWITCH_PARAMETERS

  • Se il driver miniport PF può applicare le modifiche senza richiedere una reinizializzazione della scheda di rete, il driver applica le modifiche all'hardware e completa la richiesta OID con NDIS_STATUS_SUCCESS.

    Se viene restituito questo codice di stato, NDIS aggiorna le informazioni di configurazione del commutatore della scheda di interfaccia di rete nel Registro di sistema.

  • Se il driver miniport PF richiede la reinizializzazione della scheda di rete per applicare le modifiche, il driver completa la richiesta OID con NDIS_STATUS_REINIT_REQUIRED.

    Se viene restituito questo codice di stato, NDIS aggiorna anche le informazioni di configurazione del commutatore della scheda di interfaccia di rete nel Registro di sistema. Tuttavia, il driver overlying che ha rilasciato la richiesta del set OID deve reinizializzare la scheda di rete in modo che le modifiche possano essere effettive.

    Nota I driver miniport PF che supportano la creazione e la configurazione della scheda di interfaccia di rete statica possono restituire NDIS_STATUS_REINIT_REQUIRED per assicurarsi che l'adattatore sia reinizializzato per i nuovi parametri da attivare.

  • Se il driver miniport PF non può applicare le modifiche richieste nell'OID, deve avere esito negativo sull'OID e restituire il codice NDIS_STATUS_Xxx appropriato.

    In questo caso, NDIS non aggiorna le informazioni di configurazione del commutatore della scheda di interfaccia di rete nel Registro di sistema.