Condividi tramite


OID_SRIOV_RESET_VF

I driver overlying rilasciano una richiesta di set OID (Object Identifier) di OID_SRIOV_RESET_VF per reimpostare una funzione virtuale PCI Express (PCIe) specificata in una scheda di rete che supporta la virtualizzazione I/O radice singola. I driver overlying rilasciano questa richiesta di set OID al driver miniport della funzione fisica PCI Express (PCIe) della scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SRIOV_RESET_VF_PARAMETERS . Il driver overlying specifica l'identificatore del VF da reimpostare tramite il membro VFId di questa struttura.

Commenti

Un VF può essere reimpostato tramite una reimpostazione a livello di funzione PCI Express (PCIe). Poiché la richiesta FLR è un'operazione con privilegi, può essere eseguita solo dal driver miniport PF eseguito nel sistema operativo di gestione di una partizione padre Hyper-V. I driver che vengono eseguiti nel sistema operativo di gestione ricevono una notifica della richiesta FLR e rilasciano la richiesta del set OID di OID_SRIOV_RESET_VF al driver miniport PF.

Quando gestisce questa richiesta OID, il driver miniport PF deve seguire queste linee guida:

  • Il driver miniport PF deve verificare che il VF, specificato dal membro VFId della struttura NDIS_SRIOV_RESET_VF_PARAMETERS , disponga di risorse che sono state assegnate in precedenza. Il driver miniport PF alloca le risorse per un VF durante una richiesta di metodo OID di OID_NIC_SWITCH_ALLOCATE_VF. Se le risorse per il VF specificato non sono state allocate, il driver deve non riuscire la richiesta OID.

  • L'operazione di reimpostazione deve influire solo sul VF specificato. L'operazione non deve influire su altre macchine virtuali o pf nella stessa scheda di rete.

Per altre informazioni, vedere Reimpostazione di una funzione virtuale.

Codici di stato restituiti

Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta impostata di OID_SRIOV_RESET_VF.

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 I/O (SR-IOV) radice singola o non è abilitata per l'uso dell'interfaccia.

NDIS_STATUS_INVALID_PARAMETER

Uno o più membri della struttura NDIS_SRIOV_RESET_VF_PARAMETERS hanno valori non validi.

NDIS_STATUS_INVALID_LENGTH

Il buffer delle informazioni era troppo breve. Il driver miniport PF deve impostare i DATI. SET_INFORMATION. Membro ByteNeeded nella struttura NDIS_OID_REQUEST alla dimensione minima del buffer necessaria.

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


NDIS_OID_REQUEST

NDIS_SRIOV_RESET_VF_PARAMETERS

OID_NIC_SWITCH_ALLOCATE_VF