OID_QOS_REMOTE_PARAMETERS

Article
06/15/2023

Un pilote qui se superpose émet une 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 de qoS NDIS opérationnels. Le pilote configure la carte réseau avec les paramètres opérationnels afin d’effectuer la transmission de paquets QoS.

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

Note Cette requête OID est valide uniquement pour les pilotes miniport qui prennent en charge l’interface IEEE 802.1 Data Center Bridging (DCB).

Notes

Lorsque NDIS gère correctement la requête OID de OID_QOS_REMOTE_PARAMETERS, il retourne les paramètres de qualité de service NDIS distants qu’il avait mis en cache à partir de la NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE précédente status indication qui a été émise par le pilote miniport. Le pilote émet cette indication status de rapport sur l’ensemble initial de paramètres de qoS NDIS distants. Le pilote émet également cette indication status 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 de status 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 OID de OID_QOS_REMOTE_PARAMETERS.
Si le pilote miniport n’a pas émet d’indication status NDIS_STATUS_QOS_REMOTE_PARAMETERS_CHANGE, NDIS retourne une structure 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 qualité de service NDIS distants, consultez Vue d’ensemble des paramètres de qualité de service NDIS.

Codes d’état de retour

NDIS retourne l’un des codes status 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 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. Le membre BytesNeeded dans le NDIS_OID_REQUEST structure à la taille de mémoire tampon minimale requise.
NDIS_STATUS_FAILURE	La demande a échoué pour d’autres raisons.