OID_QOS_OPERATIONAL_PARAMETERS

Articolo
06/15/2023

Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_QOS_OPERATIONAL_PARAMETERS per ottenere i parametri operativi QoS (NDIS Quality of Service) correnti per una scheda di rete. Il driver miniport configura la scheda di rete con i parametri QoS QoS operativi per eseguire la trasmissione dei pacchetti QoS QoS.

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_PARAMETERS .

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

Quando NDIS gestisce correttamente la richiesta di query OID di OID_QOS_OPERATIONAL_PARAMETERS, restituisce i parametri NDIS QoS operativi memorizzati nella cache dall'indicazione di stato precedente NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE rilasciata dal driver miniport. Il driver rilascia questa indicazione di stato per segnalare il set iniziale di parametri QoS NDIS operativi. Il driver genera anche questa indicazione di stato ogni volta che i parametri QoS NDIS operativi cambiano.

NDIS restituisce una struttura di NDIS_QOS_PARAMETERS inizializzata nel modo seguente:

Se il driver miniport ha precedentemente rilasciato un'indicazione di stato NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE, NDIS memorizza nella cache i dati NDIS_QOS_PARAMETERS e restituisce questi dati per la richiesta di query OID di OID_QOS_OPERATIONAL_PARAMETERS .
Se il driver miniport non ha generato un'indicazione di stato NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE, NDIS restituisce una struttura NDIS_QOS_PARAMETERS con tutti i membri (ad eccezione del membro Intestazione ) impostata su zero.

Per altre informazioni sui parametri QoS NDIS operativi, vedere Panoramica dei parametri QoS di NDIS.

Codici di stato restituiti

NDIS 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 informativo è minore di sizeof(NDIS_QOS_PARAMETERS). 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.