OID_NIC_SWITCH_HARDWARE_CAPABILITIES
Un driver overlying rilascia una richiesta di query OID (Object Identifier) di OID_NIC_SWITCH_HARDWARE_CAPABILITIES per ottenere le funzionalità hardware del commutatore NIC 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.
Osservazioni
La struttura NDIS_NIC_SWITCH_CAPABILITIES contiene informazioni sulle funzionalità hardware di un commutatore NIC sulla 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 NIC 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 NIC e imposta il HardwareNicSwitchCapabilities membro della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_NIC_SWITCH_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.
Nota A partire da NDIS 6.30, i driver miniport che supportano l'interfaccia di I/O radice singola (SR-IOV) devono registrare le funzionalità hardware del commutatore NIC. 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 di driver miniport e restituisce uno dei codici di stato seguenti:
| Codice di stato | Descrizione |
|---|---|
NDIS_STATUS_SUCCESS |
La richiesta è stata completata correttamente. Il InformationBuffer punta a una struttura di NDIS_NIC_SWITCH_CAPABILITIES. |
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 |
La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_NIC_SWITCH_CAPABILITIES). NDIS imposta l'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. |
Fabbisogno
Versione |
Supportato in NDIS 6.20 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |