OID_SRIOV_CURRENT_CAPABILITIES

Articolo
06/15/2023

Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_SRIOV_CURRENT_CAPABILITIES per ottenere le funzionalità di virtualizzazione I/O radice (SR-IOV) correnti di una scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore alla struttura NDIS_SRIOV_CAPABILITIES .

Commenti

A partire da NDIS 6.30, i driver miniport forniscono le funzionalità hardware SR-IOV abilitate nella scheda di rete quando viene chiamata la funzione MiniportInitializeEx . Il driver inizializza una struttura NDIS_SRIOV_CAPABILITIES con le funzionalità hardware SR-IOV attualmente abilitate e imposta il membro CurrentSriovCapabilities della 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 .

I driver di protocollo e filtro eccessivamente non devono inviare richieste di query OID di OID_SRIOV_CURRENT_CAPABILITIES.Overlying protocol and filter drivers do not have to issue OID query requests of OID_SRIOV_CURRENT_CAPABILITIES. NDIS offre le funzionalità SR-IOV attualmente abilitate di una scheda di rete a questi driver nel modo seguente:

NDIS segnala le funzionalità SR-IOV attualmente abilitate di una scheda di rete sottostante per l'overlying dei driver di protocollo nel membro SriovCapabilities della struttura NDIS_BIND_PARAMETERS durante l'operazione di associazione.
NDIS segnala le funzionalità SR-IOV attualmente abilitate di una scheda di rete sottostante per filtrare eccessivamente i driver nel membro SriovCapabilities della struttura NDIS_FILTER_ATTACH_PARAMETERS durante l'operazione di collegamento.

Codici di stato restituiti

NDIS gestisce la richiesta di query OID della richiesta di OID_SRIOV_CURRENT_CAPABILITIES per i driver miniport. I driver non verranno emessi da questa richiesta OID.

Quando NDIS gestisce la richiesta di OID_SRIOV_CURRENT_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 radice singola (SR-IOV) 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 BytesNeeded nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.