OID_QOS_OPERATIONAL_PARAMETERS

Article
06/15/2023

Un pilote qui se superpose émet une requête d’identificateur d’objet (OID) de OID_QOS_OPERATIONAL_PARAMETERS pour obtenir les paramètres opérationnels actuels de qualité de service (QoS) NDIS pour une carte réseau. Le pilote miniport configure la carte réseau avec les paramètres de qoS NDIS opérationnels afin d’effectuer la transmission de paquets QoS.

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

Note Cette demande de requête OID est gérée par NDIS pour les pilotes miniport qui prennent en charge l’interface DCB (Data Center Bridging) IEEE 802.1.

Notes

Lorsque NDIS gère correctement la requête de requête OID de OID_QOS_OPERATIONAL_PARAMETERS, il retourne les paramètres qoS NDIS opérationnels qu’il avait mis en cache à partir de la NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE précédente status indication qui a été émise par le pilote miniport. Le pilote émet cette indication status pour signaler l’ensemble initial de paramètres de qualité de service NDIS opérationnels. Le pilote émet également cette indication status chaque fois que les paramètres de qoS NDIS opérationnels changent.

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

Si le pilote miniport a précédemment émis une NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status indication, NDIS met en cache les données NDIS_QOS_PARAMETERS et retourne ces données pour la requête OID de OID_QOS_OPERATIONAL_PARAMETERS.
Si le pilote miniport n’a pas donné de NDIS_STATUS_QOS_OPERATIONAL_PARAMETERS_CHANGE status indication, NDIS retourne une structure de NDIS_QOS_PARAMETERS avec tous les membres (à l’exception du membre Header) définis sur zéro.

Pour plus d’informations sur les paramètres de qoS NDIS opérationnels, consultez Vue d’ensemble des paramètres de qoS NDIS.

Codes d’état de retour

NDIS 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_NOT_SUPPORTED	Le pilote miniport ne prend pas en charge l’interface QoS NDIS.
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.