OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Un driver eccessivamente genera una richiesta di query OID (Object Identifier) di OID_NIC_SWITCH_HARDWARE_CAPABILITIES per ottenere le funzionalità hardware del commutatore della scheda di interfaccia di rete nella scheda di rete.
Una volta restituito correttamente dalla richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_CAPABILITIES .
Commenti
La struttura NDIS_NIC_SWITCH_CAPABILITIES contiene informazioni sulle funzionalità hardware di un commutatore di interfaccia di rete nella scheda di rete. Queste funzionalità possono includere le funzionalità hardware attualmente disabilitate dalle impostazioni del file INF o tramite la pagina Delle proprietà avanzate .
Nota Tutte le funzionalità dell'opzione di interfaccia di rete specificata vengono restituite tramite una richiesta di query OID di OID_NIC_SWITCH_HARDWARE_CAPABILITIES, indipendentemente dal fatto che una funzionalità sia abilitata o disabilitata.
A partire da NDIS 6.20, i driver miniport forniscono le funzionalità hardware del commutatore NIC quando viene chiamata la funzione MiniportInitializeEx . Il driver inizializza una struttura NDIS_NIC_SWITCH_CAPABILITIES con le funzionalità hardware del commutatore della scheda di interfaccia di rete e imposta il membro HardwareNicSwitchCapabilities della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_NIC_SWITCH_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 .
Nota A partire da NDIS 6.30, i driver miniport che supportano l'interfaccia di virtualizzazione I/O radice singola (SR-IOV) devono registrare le funzionalità hardware del commutatore della scheda di interfaccia di rete. I driver registrano queste funzionalità chiamando NdisMSetMiniportAttributes.
Codici di stato restituiti
NDIS gestisce la richiesta di query OID di OID_NIC_SWITCH_HARDWARE_CAPABILITIES richiesta per i driver miniport e restituisce uno dei codici di stato seguenti:
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta è stata completata correttamente. InformationBuffer punta a una struttura NDIS_NIC_SWITCH_CAPABILITIES. |
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 |
La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_CAPABILITIES). NDIS imposta 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. |
Requisiti
Versione |
Supportato in NDIS 6.20 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |