OID_QOS_HARDWARE_CAPABILITIES

Un pilote surlysant émet une demande de requête d’identificateur d’objet (OID) de OID_QOS_HARDWARE_CAPABILITIES pour obtenir les fonctionnalités matérielles de qualité de service (QoS) NDIS d’une carte réseau.

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_CAPABILITIES.

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

La structure NDIS_QOS_CAPABILITIES contient des informations sur les fonctionnalités matérielles NDIS QoS d’une carte réseau. Ces fonctionnalités peuvent inclure des fonctionnalités matérielles actuellement désactivées par les paramètres de fichier INF ou via la page de propriétés Avancé.

Remarque toutes les fonctionnalités matérielles NDIS QoS d’une carte réseau sont retournées par le biais d’une requête de requête OID de OID_QOS_HARDWARE_CAPABILITIES, que la fonctionnalité soit activée ou désactivée.

Les pilotes Miniport enregistrent les fonctionnalités matérielles NDIS QoS d’une carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Le pilote inscrit ces fonctionnalités en procédant comme suit :

  1. Le pilote initialise une structure NDIS_QOS_CAPABILITIES avec les fonctionnalités matérielles NDIS QoS.

  2. Le pilote définit le HardwareQosCapabilities membre de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES sur un pointeur vers la structure NDIS_QOS_CAPABILITIES.

  3. Le pilote miniport appelle ensuite la fonction NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes à un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Remarque NDIS ne signale pas les fonctionnalités matérielles de la qoS NDIS d’une carte réseau pour le surajustement du protocole et du filtrage des pilotes pendant les opérations de liaison ou d’attachement.

Pour plus d’informations sur l’inscription des fonctionnalités NDIS QoS, consultez Inscription des fonctionnalités NDIS QoS.

Codes d’état de retour

NDIS gère la requête de requête OID de OID_QOS_HARDWARE_CAPABILITIES demande pour les pilotes miniports et 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_CAPABILITIES). 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.

Exigences

Version

Prise en charge dans NDIS 6.30 et versions ultérieures.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi


MiniportInitializeEx

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES

NdisMSetMiniportAttributes

NDIS_OID_REQUEST

NDIS_QOS_CAPABILITIES