OID_QOS_PARAMETERS

Articolo
06/15/2023

Il componente Data Center Bridging (DCB) (Msdcb.sys) invia una richiesta di metodo OID (Object Identifier) di OID_QOS_PARAMETERS per configurare i parametri QoS (NDIS Quality of Service) locali in una scheda di rete.

Il membro InformationBuffer della struttura NDIS_OID_REQUEST contiene un puntatore a una struttura NDIS_QOS_PARAMETERS .

Nota Questa richiesta di metodo OID è obbligatoria per i driver miniport che supportano NDIS QoS per l'interfaccia IEEE 802.1 Data Center Bridging (DCB).

Commenti

I driver Miniport ottengono i parametri QoS NDIS locali tramite una richiesta di metodo OID di OID_QOS_PARAMETERS. Questi parametri definiscono il modo in cui la scheda di rete assegna priorità alla trasmissione, o in uscita, ai pacchetti. Per altre informazioni su questi parametri, vedere Panoramica dei parametri QoS NDIS.

Nota Solo il componente DCB può inviare una richiesta di metodo OID di OID_QOS_PARAMETERS. Un driver di filtro o protocollo overlying non deve emettere questo OID. Per altre informazioni sul componente DCB, vedere Architettura QoS NDIS per Il bridging del data center.

Il componente DCB invia una richiesta di OID_QOS_PARAMETERS in base alle condizioni seguenti:

L'amministratore di sistema installa o disinstalla la funzionalità del server DCB Microsoft.

Per altre informazioni sulla funzionalità del server DCB, vedere Componenti DCB forniti dal sistema.
L'amministratore di sistema abilita o disabilita la funzionalità del server DCB mentre la funzionalità è ancora installata.
L'amministratore di sistema modifica uno dei parametri delle funzionalità del server DCB.
Il sistema operativo viene avviato o riavviato durante l'installazione della funzionalità del server DCB.

Quando il driver miniport gestisce la richiesta del metodo OID di OID_QOS_PARAMETERS, deve seguire queste linee guida:

Il driver miniport copia i dati all'interno della struttura NDIS_QOS_PARAMETERS nella cache dei parametri QoS NDIS locali. Il driver risolve quindi i parametri QoS NDIS operativi in base alla cache dei parametri QoS NDIS locali e alla cache dei parametri QoS NDIS ricevuti da un peer remoto.

Per altre informazioni su come il driver miniport risolve i parametri operativi, vedere Risoluzione dei parametri QoS NDIS operativi.
Il driver miniport non deve modificare i dati contenuti nella struttura NDIS_QOS_PARAMETERS . Il driver deve completare la richiesta del metodo OID e restituire i dati originali all'interno della struttura NDIS_QOS_PARAMETERS .
Il flag di NDIS_QOS_PARAMETERS_WILLING specifica se il driver miniport abilita o disabilita lo stato locale di Bridging Exchange (DCBX). Il driver gestisce questo flag nel modo seguente:
- Se questo flag è impostato, il driver miniport deve abilitare lo stato DCBX Willing locale. In questo modo il driver può essere configurato in remoto con le impostazioni QoS. In questo caso, il driver risolve i parametri QoS operativi in base ai parametri QoS remoti. Il driver miniport può anche risolvere i parametri QoS operativi in base a qualsiasi impostazione QoS proprietaria definita dal fornitore hardware indipendente (IHV).
- Se questo flag non è impostato, il driver miniport deve disabilitare lo stato DCBX Willing locale. Ciò consente al driver di risolvere i parametri QoS operativi dai parametri QoS locali anziché dai parametri QoS remoti. Il driver miniport deve anche disabilitare o eseguire l'override di qualsiasi parametro QoS locale per cui non è impostato il flag NDIS_QOS_PARAMETERS_Xxx correlato_CONFIGURED .
  
  Ad esempio, il driver miniport può eseguire l'override di un parametro QoS locale non configurato con le impostazioni proprietarie per il parametro QoS definito dall'IHV. Se non sono presenti impostazioni proprietarie per i parametri QoS locali non specificati con un flag NDIS_QOS_PARAMETERS_Xxx_CONFIGURED , il driver deve disabilitare l'uso di questi parametri QoS nella scheda di rete.
  
  Nota Il driver può anche eseguire l'override dei parametri QoS locali configurati se compromette i parametri QoS usati dai protocolli o dalle tecnologie abilitate nella scheda di rete. Ad esempio, il driver può eseguire l'override dei parametri QoS locali se la scheda di rete è abilitata per l'avvio remoto tramite il protocollo Fibre Channel over Ethernet (FCoE).
Per altre informazioni sullo stato DCBX Locale Disposto, vedere Gestione dello stato locale DCBX Willing.

Per altre informazioni su come il driver miniport esegue l'override dei parametri QoS locali, vedere Gestione dei parametri QoS NDIS.

Nota L'override dei parametri QoS locali non deve causare l'esito negativo della richiesta del metodo OID del driver miniport di OID_QOS_PARAMETERS.

Per altre informazioni su come il driver miniport gestisce i parametri QoS locali, vedere Impostazione dei parametri QoS NDIS locali.

Codici di stato restituiti

Il driver miniport restituisce uno dei codici di stato seguenti.

Codice di stato	Descrizione
NDIS_STATUS_SUCCESS	La richiesta OID è stata completata correttamente.
NDIS_STATUS_PENDING	La richiesta OID è in attesa di completamento. Quando il driver miniport chiama NdisMOidRequestComplete, NDIS passerà il codice di stato finale e i risultati al gestore di completamento della richiesta OID del chiamante dopo il completamento della richiesta.
NDIS_STATUS_NOT_SUPPORTED	Il driver miniport non supporta l'interfaccia QoS NDIS.
NDIS_STATUS_INVALID_PARAMETER	Uno o più membri della struttura NDIS_QOS_PARAMETERS contengono valori non corretti.
NDIS_STATUS_INVALID_LENGTH	La lunghezza del buffer delle informazioni è minore di sizeof(NDIS_QOS_PARAMETERS). 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.