OID_QOS_CURRENT_CAPABILITIES
Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_QOS_CURRENT_CAPABILITIES per ottenere le funzionalità hardware QoS (NDIS Quality of Service) attualmente abilitate di una 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_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
I driver Miniport registrano le funzionalità hardware QoS NDIS attualmente abilitate di una scheda di rete quando viene chiamata la funzione MiniportInitializeEx . Il driver registra queste funzionalità seguendo questa procedura:
Il driver inizializza una struttura NDIS_QOS_CAPABILITIES con le funzionalità hardware QoS abilitate.
Il driver imposta il membro CurrentQosCapabilities della struttura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES su un puntatore alla struttura NDIS_QOS_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 NDIS non segnala le funzionalità hardware QoS NDIS attualmente abilitate per una scheda di rete per l'overlying dei driver di protocollo e filtro 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_CURRENT_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 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.30 e versioni successive. |
Intestazione |
Ntddndis.h (include Ndis.h) |