OID_SRIOV_HARDWARE_CAPABILITIES

Articolo
06/15/2023

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.