OID_SRIOV_HARDWARE_CAPABILITIES
Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_SRIOV_HARDWARE_CAPABILITIES per ottenere le funzionalità hardware di I/O (SR-IOV) singole della scheda di rete.
Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore alla struttura NDIS_SRIOV_CAPABILITIES .
Commenti
La struttura NDIS_SRIOV_CAPABILITIES contiene informazioni sulle funzionalità hardware della scheda di rete, ad esempio se la scheda supporta SR-IOV e se il driver miniport gestisce la funzione fisica PCI Express (PCIe) dell'adattatore o la funzione virtuale (VF). Queste funzionalità possono includere le funzionalità hardware attualmente disabilitate dalle impostazioni del file INF o tramite la pagina Proprietà avanzate .
Nota Tutte le funzionalità SR-IOV della scheda di rete vengono restituite tramite una richiesta di query OID di OID_SRIOV_HARDWARE_CAPABILITIES, indipendentemente dal fatto che una funzionalità sia abilitata o disabilitata.
A partire da NDIS 6.30, i driver miniport forniscono le funzionalità hardware SR-IOV quando viene chiamata la funzione MiniportInitializeEx . Il driver inizializza una struttura NDIS_SRIOV_CAPABILITIES con le funzionalità hardware SR-IOV e imposta il membro HardwareSriovCapabilitiesdella struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_SRIOV_CAPABILITIES . Il driver miniport chiama quindi la funzione NdisMSetMiniportAttributes e imposta il parametro MiniportAttributes su un puntatore a una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Codici di stato restituiti
NDIS gestisce la richiesta di query OID della richiesta di OID_SRIOV_HARDWARE_CAPABILITIES per i driver miniport. I driver non verranno emessi questa richiesta OID.
Quando NDIS gestisce la richiesta di OID_SRIOV_HARDWARE_CAPABILITIES, restituisce uno dei codici di stato seguenti.
Codice di stato | Descrizione |
---|---|
NDIS_STATUS_SUCCESS |
La richiesta OID è stata completata correttamente. |
NDIS_STATUS_NOT_SUPPORTED |
Il driver miniport non supporta l'interfaccia di virtualizzazione I/O (SR-IOV) radice singola o non è abilitata per l'uso dell'interfaccia. |
NDIS_STATUS_INVALID_LENGTH |
Il buffer delle informazioni era troppo breve. Il driver miniport deve impostare i DATI. QUERY_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) |