Condividi tramite


OID_NIC_SWITCH_CURRENT_CAPABILITIES

Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_NIC_SWITCH_CURRENT_CAPABILITIES per ottenere le funzionalità hardware attualmente abilitate del commutatore di interfaccia di rete in una scheda di rete.

Dopo aver restituito correttamente la richiesta di query OID, il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_NIC_SWITCH_CAPABILITIES .

Commenti

A partire da NDIS 6.20, i driver miniport forniscono le funzionalità hardware del commutatore di interfaccia di rete attualmente abilitate nella scheda di rete quando viene chiamata la funzione MiniportInitializeEx . Il driver inizializza una struttura NDIS_NIC_SWITCH_CAPABILITIES con le funzionalità hardware del commutatore di interfaccia di rete e imposta il membro CurrentNicSwitchCapabilitiesdella 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 abilitate del commutatore della scheda di interfaccia di rete. I driver registrano queste funzionalità chiamando NdisMSetMiniportAttributes.

I driver di filtro e protocollo overlying non devono inviare richieste di query OID di OID_NIC_SWITCH_CURRENT_CAPABILITIES. NDIS offre le funzionalità hardware del commutatore di interfaccia di rete attualmente abilitate di una scheda di rete a questi driver nel modo seguente:

  • NDIS segnala le funzionalità hardware del commutatore di interfaccia di rete attualmente abilitate di una scheda di rete sottostante per sovralimentare i driver di protocollo nel membro NicSwitchCapabilitiesdella struttura NDIS_BIND_PARAMETERS durante l'operazione di associazione.

  • NDIS segnala le funzionalità hardware del commutatore di interfaccia di rete attualmente abilitate di una scheda di rete sottostante per filtrare i driver nel membro NicSwitchCapabilitiesdella 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_NIC_SWITCH_CURRENT_CAPABILITIES per i driver miniport. I driver non verranno emessi questa richiesta OID.

Quando NDIS gestisce la richiesta di OID_NIC_SWITCH_CURRENT_CAPABILITIES, 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 (SR-IOV) radice singola o non è abilitata per l'uso dell'interfaccia.

NDIS_STATUS_INVALID_LENGTH

La lunghezza del buffer informativo è minore di sizeof(NDIS_NIC_SWITCH_CAPABILITIES). 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.

Requisiti

Versione

Supportato in NDIS 6.20 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedi anche

NDIS_BIND_PARAMETERS

NDIS_FILTER_ATTACH_PARAMETERS

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NDIS_NIC_SWITCH_CAPABILITIES

NDIS_OID_REQUEST