fonction HidP_GetValueCaps (hidpi.h)

Article
03/01/2024

La routine HidP_GetValueCaps retourne un tableau de fonctionnalités de valeurs qui décrit toutes les valeurs de contrôle HID d’une collection de niveau supérieur pour un type spécifié de rapport HID.

Syntaxe

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Paramètres

[in] ReportType

Spécifie une valeur d’énumérateur HIDP_REPORT_TYPE qui identifie le type de rapport.

[out] ValueCaps

Pointeur vers une mémoire tampon allouée à l’appelant dans laquelle la routine retourne un tableau de capacité de valeur pour le type de rapport spécifié.

[in, out] ValueCapsLength

Spécifie la longueur, en entrée, dans les éléments de tableau, de la mémoire tampon ValueCaps . Lors de la sortie, la routine définit ValueCapsLength sur le nombre d’éléments qu’elle retourne réellement.

[in] PreparsedData

Pointeur vers les données préparées d’une collection de niveau supérieur.

Valeur retournée

HidP_GetValueCaps retourne l’une des valeurs status suivantes :

Code de retour	Description
HIDP_STATUS_SUCCESS	La routine a correctement retourné les données de fonctionnalité.
HIDP_STATUS_INVALID_PREPARSED_DATA	Les données préparées ne sont pas valides.

Remarques

La longueur correcte pour ValueCapsLength est spécifiée par les membres NumberXxxValueCaps de la structure HIDP_CAPS d’une collection de niveau supérieur.

Pour plus d’informations sur la fonctionnalité d’une collection, consultez Obtention d’informations de collection.

Voir aussi Les collections HID.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	hidpi.h (inclure Hidpi.h)
Bibliothèque	Hidparse.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

Partager via