OID_QOS_REMOTE_PARAMETERS

Article
03/13/2025

Un pilote surlysant émet une demande de requête d’identificateur d’objet (OID) de OID_QOS_REMOTE_PARAMETERS pour obtenir les paramètres de qualité de service (QoS) NDIS pour un homologue distant. Le pilote miniport utilise ces paramètres QoS distants pour résoudre ses paramètres NDIS QoS opérationnels. Le pilote configure la carte réseau avec les paramètres opérationnels afin d’effectuer la transmission des paquets QoS.

Après un retour réussi de la requête OID, le InformationBuffer membre de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_QOS_PARAMETERS.

Remarque Cette demande de requête OID n’est valide que pour les pilotes miniport qui prennent en charge l’interface DCB (Data Center Bridging) IEEE 802.1.

Remarques

Lorsque NDIS gère correctement la requête OID de OID_QOS_REMOTE_PARAMETERS, elle retourne les paramètres de qoS NDIS distants qu’il avait mis en cache à partir de l’indication d’état de NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE précédente qui a été émise par le pilote miniport. Le pilote émet cette indication d’état pour signaler l’ensemble initial de paramètres NDIS QoS distants. Le pilote émet également cette indication d’état chaque fois que les paramètres de qoS NDIS distants changent.

NDIS retourne une structure NDIS_QOS_PARAMETERS initialisée de la manière suivante :

Si le pilote miniport a précédemment émis une indication d’état NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS met en cache les données NDIS_QOS_PARAMETERS et retourne ces données pour la requête de requête OID de OID_QOS_REMOTE_PARAMETERS.
Si le pilote miniport n’a pas émettre d’indication d’état NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS retourne une structure NDIS_QOS_PARAMETERS avec tous les membres (à l’exception de l’en-tête membre) défini sur zéro.

Pour plus d’informations sur les paramètres NDIS QoS distants, consultez Vue d’ensemble des paramètres NDIS QoS.

Codes d’état de retour

NDIS retourne l’un des codes d’état suivants.

Code d’état	Description
NDIS_STATUS_SUCCESS	La requête OID s’est terminée avec succès.
NDIS_STATUS_NOT_SUPPORTED	Le pilote miniport ne prend pas en charge l’interface NDIS QoS.
NDIS_STATUS_INVALID_LENGTH	La longueur de la mémoire tampon d’informations est inférieure à sizeof(NDIS_QOS_PARAMETERS). NDIS définit le DATA. QUERY_INFORMATION. OctetsNeeded membre de la structure NDIS_OID_REQUEST à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.