OID_QOS_REMOTE_PARAMETERS

Articolo
06/15/2023

Un driver overlying genera una richiesta di query OID (Object Identifier) di OID_QOS_REMOTE_PARAMETERS per ottenere i parametri NDIS Quality of Service (QoS) per un peer remoto. Il driver miniport usa questi parametri QoS remoti per risolvere i relativi parametri QoS operativi. Il driver configura la scheda di rete con i parametri operativi per eseguire la trasmissione dei pacchetti 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 è valida solo per i driver miniport che supportano l'interfaccia IEEE 802.1 Data Center Bridging (DCB).

Commenti

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

NDIS restituisce una struttura di NDIS_QOS_PARAMETERS inizializzata nel modo seguente:

Se il driver miniport ha rilasciato in precedenza un'indicazione di stato NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS memorizza nella cache i dati di NDIS_QOS_PARAMETERS e restituisce questi dati per la richiesta di query OID di OID_QOS_REMOTE_PARAMETERS .
Se il driver miniport non ha generato un'indicazione di stato NDIS_STATUS_QOS_REMOTE_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 remoti, vedere Panoramica dei parametri QoS 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.