OID_QOS_PARAMETERS

Le composant Data Center Bridging (DCB) (Msdcb.sys) émet une demande de méthode d’identificateur d’objet (OID) de OID_QOS_PARAMETERS pour configurer les paramètres de qualité de service (QoS) NDIS locaux sur une carte réseau.

Le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_QOS_PARAMETERS.

Remarque Cette demande de méthode OID est obligatoire pour les pilotes miniports qui prennent en charge la qoS NDIS pour l’interface IEEE 802.1 Data Center Bridging (DCB).

Remarques

Les pilotes miniport obtiennent les paramètres NDIS QoS locaux par le biais d’une requête de méthode OID de OID_QOS_PARAMETERS. Ces paramètres définissent la façon dont la carte réseau hiérarchise la transmission, ou sortie, paquets. Pour plus d’informations sur ces paramètres, consultez Vue d’ensemble des paramètres NDIS QoS.

Remarque Seul le composant DCB peut émettre une requête de méthode OID de OID_QOS_PARAMETERS. Un protocole ou un pilote de filtre excessive ne doit pas émettre cet OID. Pour plus d’informations sur le composant DCB, consultez architecture NDIS QoS pour data Center Bridging.

Le composant DCB émet une demande de OID_QOS_PARAMETERS dans les conditions suivantes :

• L’administrateur système installe ou désinstalle la fonctionnalité serveur Microsoft DCB.

  Pour plus d’informations sur la fonctionnalité serveur DCB, consultez System-Provided composants DCB.

• L’administrateur système active ou désactive la fonctionnalité serveur DCB pendant l’installation de la fonctionnalité.

• L’administrateur système modifie l’un des paramètres de fonctionnalité du serveur DCB.

• Le système d’exploitation démarre ou redémarre pendant l’installation de la fonctionnalité serveur DCB.

Lorsque le pilote miniport gère la demande de méthode OID de OID_QOS_PARAMETERS, il doit suivre les instructions suivantes :

• Le pilote miniport copie les données de la structure NDIS_QOS_PARAMETERS dans son cache des paramètres NDIS QoS locaux. Le pilote résout ensuite ses paramètres NDIS QoS opérationnels en fonction de son cache des paramètres NDIS QoS locaux et de son cache de paramètres NDIS QoS qu’il a reçus d’un homologue distant.

  Pour plus d’informations sur la façon dont le pilote miniport résout ses paramètres opérationnels, consultez Résolution des paramètres de qoS NDIS opérationnels.

• Le pilote miniport ne doit pas modifier les données contenues dans la structure NDIS_QOS_PARAMETERS. Le pilote doit effectuer la requête de méthode OID et retourner les données d’origine dans la structure NDIS_QOS_PARAMETERS.

• L’indicateur NDIS_QOS_PARAMETERS_WILLING spécifie si le pilote miniport active ou désactive l’état DCBX (Data Center Bridging Exchange) local. Le pilote gère cet indicateur de la façon suivante :

  • Si cet indicateur est défini, le pilote miniport doit activer l’état local DCBX Willing. Cela permet au pilote d’être configuré à distance avec les paramètres QoS. Dans ce cas, le pilote résout ses paramètres qoS opérationnels en fonction des paramètres QoS distants. Le pilote miniport peut également résoudre ses paramètres qoS opérationnels en fonction de tous les paramètres qoS propriétaires définis par le fournisseur de matériel indépendant (IHV).

  • Si cet indicateur n’est pas défini, le pilote miniport doit désactiver l’état local DCBX Willing. Cela permet au pilote de résoudre ses paramètres QoS opérationnels à partir de ses paramètres QoS locaux au lieu des paramètres QoS distants. Le pilote miniport doit également désactiver ou remplacer tout paramètre QoS local pour lequel l’indicateur de NDIS_QOS_PARAMETERS_Xxx_CONFIGURED associé n’est pas défini.

    Par exemple, le pilote miniport peut remplacer un paramètre QoS local non configuré avec ses paramètres propriétaires pour le paramètre QoS défini par l’IHV. S’il n’existe aucun paramètre propriétaire pour les paramètres QoS locaux qui ne sont pas spécifiés avec un indicateur NDIS_QOS_PARAMETERS_Xxx_CONFIGURED, le pilote doit désactiver l’utilisation de ces paramètres QoS sur la carte réseau.

    Remarque Le pilote peut également remplacer les paramètres QoS locaux configurés s’ils compromissaient les paramètres QoS utilisés par les protocoles ou technologies activés sur la carte réseau. Par exemple, le pilote peut remplacer les paramètres QoS locaux si la carte réseau est activée pour le démarrage à distance via le protocole Fibre Channel sur Ethernet (FCoE).

  Pour plus d’informations sur l’état DCBX Willing local, consultez Gestion de l’état prêt DCBX local.

Pour plus d’informations sur la façon dont le pilote miniport remplace les paramètres QoS locaux, consultez Gestion des paramètres de qoS NDIS.

Remarque Remplacer les paramètres QoS locaux ne doit pas entraîner l’échec du pilote miniport à la demande de méthode OID de OID_QOS_PARAMETERS.

Pour plus d’informations sur la façon dont le pilote miniport gère les paramètres QoS locaux, consultez Définition des paramètres de qoS NDIS locaux.

Codes d’état de retour

Le pilote miniport retourne l’un des codes d’état suivants.

Exigences

Voir aussi

NdisMOidRequestComplete

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES

NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE

NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE