OID_QOS_HARDWARE_CAPABILITIES
Un pilote qui se superpose é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 de requête OID, le membre InformationBuffer de la structure NDIS_OID_REQUEST contient un pointeur vers une structure NDIS_QOS_CAPABILITIES .
Note Cette 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).
Notes
La structure NDIS_QOS_CAPABILITIES contient des informations sur les fonctionnalités matérielles de qoS NDIS 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 Propriétés avancées .
Note Toutes les fonctionnalités matérielles NDIS QoS d’une carte réseau sont retournées par le biais d’une requête OID de OID_QOS_HARDWARE_CAPABILITIES, qu’une fonctionnalité soit activée ou désactivée.
Les pilotes Miniport enregistrent les fonctionnalités matérielles qoS NDIS d’une carte réseau lorsque sa fonction MiniportInitializeEx est appelée. Le pilote inscrit ces fonctionnalités en procédant comme suit :
Le pilote initialise une structure de NDIS_QOS_CAPABILITIES avec les fonctionnalités matérielles de qoS NDIS.
Le pilote définit le membre HardwareQosCapabilities de la structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES sur un pointeur vers la structure NDIS_QOS_CAPABILITIES .
Le pilote miniport appelle ensuite la fonction NdisMSetMiniportAttributes et définit le paramètre MiniportAttributes sur un pointeur vers une structure NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES .
Note NDIS ne signale pas les fonctionnalités matérielles de qoS NDIS d’une carte réseau aux pilotes de protocole et de filtre sur-ment pendant les opérations de liaison ou d’attachement.
Pour plus d’informations sur l’inscription des fonctionnalités qoS NDIS, consultez Inscription des fonctionnalités qoS NDIS.
Codes d’état de retour
NDIS gère la requête OID de OID_QOS_HARDWARE_CAPABILITIES demande pour les pilotes miniport et retourne l’un des codes de 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_CAPABILITIES). 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. |
Spécifications
Version |
Pris en charge dans NDIS 6.30 et versions ultérieures. |
En-tête |
Ntddndis.h (inclure Ndis.h) |