OID_QOS_HARDWARE_CAPABILITIES

Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_QOS_HARDWARE_CAPABILITIES per ottenere le funzionalità hardware QoS (NDIS Quality of Service) di 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_QOS_CAPABILITIES .

Nota Questa richiesta di query OID viene gestita da NDIS per i driver miniport che supportano l'interfaccia IEEE 802.1 Data Center Bridging (DCB).

Commenti

La struttura NDIS_QOS_CAPABILITIES contiene informazioni sulle funzionalità hardware QoS di NDIS di una scheda di rete. Queste funzionalità possono includere funzionalità hardware attualmente disabilitate dalle impostazioni del file INF o tramite la pagina Proprietà avanzate .

Nota Tutte le funzionalità hardware QoS di NDIS di una scheda di rete vengono restituite tramite una richiesta di query OID di OID_QOS_HARDWARE_CAPABILITIES, indipendentemente dal fatto che una funzionalità sia abilitata o disabilitata.

I driver Miniport registrano le funzionalità hardware QoS NDIS di una scheda di rete quando viene chiamata la funzione MiniportInitializeEx . Il driver registra queste funzionalità seguendo questa procedura:

  1. Il driver inizializza una struttura NDIS_QOS_CAPABILITIES con le funzionalità hardware QoS NDIS.

  2. Il driver imposta il membro HardwareQosCapabilities della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_QOS_CAPABILITIES .

  3. 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 NDIS non segnala le funzionalità hardware QoS di NDIS di una scheda di rete per sovralimentare il protocollo e filtrare i driver durante le operazioni di associazione o collegamento.

Per altre informazioni su come registrare le funzionalità QoS di NDIS, vedere Registrazione delle funzionalità QoS di NDIS.

Codici di stato restituiti

NDIS gestisce la richiesta di query OID di OID_QOS_HARDWARE_CAPABILITIES richiesta per i driver miniport e 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 QoS NDIS.

NDIS_STATUS_INVALID_LENGTH

La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_QOS_CAPABILITIES). NDIS imposta 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.30 e versioni successive.

Intestazione

Ntddndis.h (include Ndis.h)

Vedi anche


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES