OID_SRIOV_CURRENT_CAPABILITIES

2025-03-13

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

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

Osservazioni

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 di NDIS_SRIOV_CAPABILITIES con le funzionalità hardware SR-IOV attualmente abilitate e imposta il CurrentSriovCapabilities membro della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_SRIOV_CAPABILITIES. Il driver miniport chiama quindi il NdisMSetMiniportAttributes funzione e imposta il parametro MiniportAttributes su un puntatore a una struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

L'overlying di protocolli e driver di filtro non deve emettere richieste di query OID di OID_SRIOV_CURRENT_CAPABILITIES. NDIS offre le funzionalità di SR-IOV attualmente abilitate di una scheda di rete per questi driver nel modo seguente:

NDIS segnala le funzionalità di SR-IOV attualmente abilitate di una scheda di rete sottostante per l'overlying dei driver di protocollo nel SriovCapabilities membro della struttura NDIS_BIND_PARAMETERS durante l'operazione di associazione.
NDIS segnala le funzionalità di SR-IOV attualmente abilitate di una scheda di rete sottostante per filtrare eccessivamente i driver nel SriovCapabilities membro 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 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	Richiesta OID completata.
NDIS_STATUS_NOT_SUPPORTED	Il driver miniport non supporta l'interfaccia di virtualizzazione di 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 il DATA. QUERY_INFORMATION. BytesNeeded membro nella struttura NDIS_OID_REQUEST alle dimensioni minime del buffer necessarie.
NDIS_STATUS_FAILURE	La richiesta non è riuscita per altri motivi.