OID_NIC_SWITCH_CREATE_SWITCH

Articolo
06/15/2023

NDIS emette una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_CREATE_SWITCH per creare un commutatore di interfaccia di rete su una scheda di rete. Quando gestisce questa richiesta OID, il driver miniport alloca le risorse per l'interruttore della scheda di interfaccia di rete.

NDIS invia questa richiesta di metodo OID al driver miniport della funzione fisica PCI Express (PCIe) della scheda di rete. Questa richiesta di metodo OID è necessaria per i driver miniport PF che supportano l'interfaccia SR-IOV (Single Root I/O Virtualization).

Nota I driver overlying, ad esempio i driver di protocollo o filtro, non possono inviare richieste di metodi OID di OID_NIC_SWITCH_CREATE_SWITCH al driver miniport PF.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_PARAMETERS .

Commenti

Quando riceve la richiesta del metodo OID di OID_NIC_SWITCH_CREATE_SWITCH, il driver miniport PF deve eseguire le operazioni seguenti:

Se il driver miniport PF supporta la creazione e la configurazione del commutatore statico, crea l'opzione NIC quando NDIS chiama MiniportInitializeEx. Quando il driver gestisce questa richiesta OID, deve verificare i parametri di configurazione nella struttura NDIS_NIC_SWITCH_PARAMETERS . I parametri devono essere uguali a quelli usati dal driver per creare l'opzione durante la chiamata a MiniportInitializeEx. In caso contrario, il driver deve non riuscire la richiesta OID.

Per altre informazioni, vedere Creazione statica di un commutatore di scheda di interfaccia di rete.
Se il driver miniport PF supporta la creazione e la configurazione del commutatore dinamico, il driver deve convalidare i valori di configurazione della struttura NDIS_NIC_SWITCH_PARAMETERS e creare l'opzione di interfaccia di rete in base a questi valori.

Per altre informazioni, vedere Creazione dinamica di un commutatore di scheda di interfaccia di rete.
Il driver miniport PF deve allocare le risorse hardware e software necessarie per il VPort predefinito nel commutatore NIC.

Nota Il VPort predefinito viene sempre creato tramite una richiesta OID di OID_NIC_SWITCH_CREATE_SWITCH ed eliminata tramite una richiesta OID di OID_NIC_SWITCH_DELETE_SWITCH. Le richieste OID di OID_NIC_SWITCH_CREATE_VPORT e OID_NIC_SWITCH_DELETE_VPORT vengono usate per la creazione e l'eliminazione di VPort non predefiniti nell'opzione della scheda di interfaccia di rete.
Il driver miniport PF che supporta la creazione e la configurazione del commutatore dinamico devono abilitare la virtualizzazione SR-IOV sul commutatore chiamando NdisMEnableVirtualization. Questa chiamata configura il membro NumVFs e il bit VF Enable nella struttura SR-IOV Extended Capability dello spazio di configurazione PCI Express (PCIe) dell'adattatore.

Per altre informazioni sullo spazio di configurazione SR-IOV, vedere la specifica PCI-SIG Single Root I/O Virtualization and Sharing 1.1 .

Nota Se il driver miniport PF supporta la creazione di commutatori statici, abilita la virtualizzazione SR-IOV dopo aver creato il commutatore quando viene chiamato MiniportInitializeEx .

Se il driver miniport PF completa correttamente la richiesta del metodo OID di OID_NIC_SWITCH_CREATE_SWITCH, consente di eseguire le operazioni seguenti:

Le VFS possono essere allocate nel commutatore della scheda di interfaccia di rete tramite richieste di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.
È possibile creare VPort non predefiniti nel commutatore della scheda di interfaccia di rete tramite richieste di metodo OID di OID_NIC_SWITCH_CREATE_VPORT.

Per altre informazioni su come gestire questa richiesta OID, vedere Gestione della richiesta di OID_NIC_SWITCH_CREATE_SWITCH.

Codici di stato restituiti

Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta del metodo OID di OID_NIC_SWITCH_CREATE_SWITCH.

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 SR-IOV o non è abilitato 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	La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_PARAMETERS). Il driver miniport PF deve impostare i DATI. METHOD_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.