OID_SRIOV_VF_VENDOR_DEVICE_ID
Un driver overlying genera una richiesta di metodo OID (Object Identifier) di OID_SRIOV_VF_VENDOR_DEVICE_ID per eseguire una query sull'identificatore del dispositivo PCI Express (PCIe) e sull'identificatore del fornitore (DeviceID) per una scheda di rete PCI Express (PCIe) Virtual Function (VF). Questa scheda di rete virtuale viene esposta nella partizione figlio Hyper-V collegata alla scheda di rete virtuale.
I driver overlying rilasciano 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 di virtualizzazione I/O (SR-IOV) singola.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO .
Commenti
Prima di eseguire questa richiesta di metodo OID, il driver overlying deve inizializzare una struttura NDIS_SRIOV_VF_VENDOR_DEVICE_ID_INFO e deve impostare il membro VFId sull'identificatore del VF da cui leggere le informazioni.
Quando gestisce questa richiesta OID, il driver miniport PF deve verificare che il VF specificato abbia 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.
Per altre informazioni, vedere Esecuzione di query sui fornitori PCI e identificatori di dispositivo per una funzione virtuale.
Codici di stato restituiti
Il driver miniport PF restituisce uno dei codici di stato seguenti per la richiesta del metodo OID di OID_SRIOV_VF_VENDOR_DEVICE_ID.
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_VF_VENDOR_DEVICE_ID_INFO hanno valori non validi. |
NDIS_STATUS_INVALID_LENGTH |
Il buffer delle informazioni era troppo breve. NDIS imposta i DATI. METHOD_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) |