OID_QOS_PARAMETERS
Le composant DCB (Data Center Bridging) (Msdcb.sys) émet une demande de méthode d’identificateur d’objet (OID) de OID_QOS_PARAMETERS pour configurer les paramètres locaux de qualité de service (QoS) NDIS sur une carte réseau.
Le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_QOS_PARAMETERS .
Note Cette demande de méthode OID est obligatoire pour les pilotes miniports qui prennent en charge la qualité de service NDIS pour l’interface DCB (Data Center Bridging) IEEE 802.1.
Notes
Les pilotes miniport obtiennent les paramètres de qoS NDIS locaux par le biais d’une demande de méthode OID de OID_QOS_PARAMETERS. Ces paramètres définissent la façon dont la carte réseau hiérarchise les paquets de transmission ou de sortie. Pour plus d’informations sur ces paramètres, consultez Vue d’ensemble des paramètres qoS NDIS.
Note Seul le composant DCB peut émettre une demande de méthode OID de OID_QOS_PARAMETERS. Un protocole ou un pilote de filtre trop important ne doit pas émettre cet OID. Pour plus d’informations sur le composant DCB, consultez Architecture qoS NDIS pour le pontage du centre de données.
Le composant DCB émet une demande de OID_QOS_PARAMETERS dans les conditions suivantes :
L’administrateur système installe ou désinstalle la fonctionnalité de serveur Microsoft DCB.
Pour plus d’informations sur la fonctionnalité de serveur DCB, consultez Composants DCB fournis par le système.
L’administrateur système active ou désactive la fonctionnalité de serveur DCB tant que la fonctionnalité est toujours installée.
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é de 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 au sein de la structure NDIS_QOS_PARAMETERS dans son cache de paramètres de qualité de service NDIS locaux. Le pilote résout ensuite ses paramètres de qoS NDIS opérationnels en fonction de son cache de paramètres de qoS NDIS locaux et de son cache de paramètres de qoS NDIS 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 terminer la demande 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 manière suivante :
Si cet indicateur est défini, le pilote miniport doit activer l’état DCBX Willing local. 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 de qualité de service 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 DCBX Willing local. 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 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.
Note Le pilote peut également remplacer les paramètres qoS locaux configurés s’ils compromettent 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 qoS NDIS.
Note La substitution des 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 status suivants.
| Code d’état | Description |
|---|---|
NDIS_STATUS_SUCCESS |
La demande OID s’est terminée avec succès. |
NDIS_STATUS_PENDING |
La requête OID est en attente d’achèvement. Lorsque le pilote miniport appelle NdisMOidRequestComplete, NDIS transmet le code status final et les résultats au gestionnaire de saisie semi-automatique de la requête OID de l’appelant une fois la demande terminée. |
NDIS_STATUS_NOT_SUPPORTED |
Le pilote miniport ne prend pas en charge l’interface QoS NDIS. |
NDIS_STATUS_INVALID_PARAMETER |
Un ou plusieurs membres de la structure NDIS_QOS_PARAMETERS contiennent des valeurs incorrectes. |
NDIS_STATUS_INVALID_LENGTH |
La longueur de la mémoire tampon d’informations est inférieure à sizeof(NDIS_QOS_PARAMETERS). NDIS définit les DONNÉES. QUERY_INFORMATION. BytesNeeded membre dans la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise. |
NDIS_STATUS_FAILURE |
La demande a échoué pour d’autres raisons. |
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |