OID_NIC_SWITCH_VF_PARAMETERS

Articolo
06/15/2023

Un driver o un'applicazione in modalità utente genera una richiesta di metodo OID (Object Identifier) di OID_NIC_SWITCH_VF_PARAMETERS per ottenere i parametri di configurazione correnti di una funzione virtuale PCI Express (PCIe) in una scheda di rete. Solo le macchine virtuali con risorse allocate tramite una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF possono essere sottoposte a query tramite una richiesta di metodo OID di OID_NIC_SWITCH_VF_PARAMETERS.

NDIS gestisce la richiesta del metodo OID di OID_NIC_SWITCH_VF_PARAMETERS per i driver miniport.

Quando viene effettuata la richiesta del metodo OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_VF_PARAMETERS .

Commenti

L'applicazione overlying driver o user-mode specifica la funzione VF da eseguire tramite l'impostazione del membro VFId della struttura NDIS_NIC_SWITCH_VF_PARAMETERS sull'identificatore della funzione VF. Il driver o l'applicazione overlying ottiene l'identificatore VF tramite uno dei modi seguenti:

Inviando una richiesta di metodo OID di OID_NIC_SWITCH_ENUM_VFS.

Se questa richiesta OID viene completata correttamente, l'applicazione overlying driver o user-mode riceve un elenco di tutte le macchine virtuali allocate nella scheda di rete. Ogni elemento all'interno dell'elenco è una struttura NDIS_NIC_SWITCH_VF_INFO , con l'identificatore VF specificato dal membro VFId .
Inviando una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF.

Se questa richiesta OID viene completata correttamente, il driver overlying riceve l'identificatore del VF appena creato nel membro VFId della struttura NDIS_NIC_SWITCH_VF_PARAMETERS restituita.

Nota Solo i driver eccessivamente in grado di ottenere l'identificatore VF in questo modo.

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_VF_PARAMETERS . Questa struttura contiene i parametri di configurazione per il VF specificato.

Codici di stato restituiti

NDIS gestisce la richiesta del metodo OID di OID_NIC_SWITCH_VF_PARAMETERS per i driver miniport e restituisce il codice di stato seguente per le richieste di metodi OID di OID_NIC_SWITCH_VF_PARAMETERS.

Codice di stato	Descrizione
NDIS_STATUS_SUCCESS	La richiesta è stata completata correttamente. Il membro InformationBuffer punta a una struttura NDIS_NIC_SWITCH_VF_PARAMETERS .
NDIS_STATUS_NOT_SUPPORTED	Il driver miniport 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_VF_PARAMETERS hanno valori non validi.
NDIS_STATUS_INVALID_LENGTH	La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_VF_PARAMETERS). NDIS imposta i DATI. METHOD_INFORMATION. Membro BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_INVALID_LENGTH	Il buffer delle informazioni era troppo breve. NDIS imposta 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.