OID_QOS_OPERATIONAL_PARAMETERS

Article
03/13/2025

Un pilote surlysant émet une demande de requête d’identificateur d’objet (OID) de OID_QOS_OPERATIONAL_PARAMETERS pour obtenir les paramètres opérationnels de qualité de service (QoS) NDIS actuels pour une carte réseau. Le pilote miniport configure la carte réseau avec les paramètres NDIS QoS opérationnels afin d’effectuer la transmission de 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 est gérée par NDIS pour les pilotes miniport qui prennent en charge l’interface IEEE 802.1 Data Center Bridging (DCB).

Remarques

Lorsque NDIS gère correctement la requête de requête OID de OID_QOS_OPERATIONAL_PARAMETERS, elle retourne les paramètres de qoS NDIS opérationnels qu’il avait mis en cache à partir de l’indication d’état NDIS_STATUS_QOS_OPERATIONAL_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 opérationnels. Le pilote émet également cette indication d’état chaque fois que les paramètres de qoS NDIS opérationnels 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_OPERATIONAL_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_OPERATIONAL_PARAMETERS.
Si le pilote miniport n’a pas émettre d’indication d’état de NDIS_STATUS_QOS_OPERATIONAL_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 opérationnels, 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.