fonction HidP_SetScaledUsageValue (hidpi.h)
La routine HidP_SetScaledUsageValue convertit un numéro physique signé et mis à l’échelle en une valeur logique d’utilisation HID et définit la valeur d’utilisation dans un rapport HID spécifié.
Syntaxe
NTSTATUS HidP_SetScaledUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[in] LONG UsageValue,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in, out] PCHAR Report,
[in] ULONG ReportLength
);
Paramètres
[in] ReportType
Spécifie une valeur d’énumérateur HIDP_REPORT_TYPE qui indique le type de rapport HID situé à Rapport.
[in] UsagePage
Spécifie la page d’utilisation d’une utilisation.
[in] LinkCollection
Spécifie la collection de liens qui contient l’utilisation. Si LinkCollection n’est pas zéro, la routine définit uniquement l’utilisation, le cas échéant, dans cette collection de liens. Si LinkCollection est égal à zéro, la routine définit la première utilisation qu’elle trouve dans la collection de niveau supérieur associée à PreparsedData.
[in] Usage
Spécifie l’utilisation.
[in] UsageValue
Spécifie le numéro physique signé et mis à l’échelle, que la routine convertit en valeur logique de l’utilisation.
[in] PreparsedData
Pointeur vers le de données prédéfinies d’un niveau supérieur.
[in, out] Report
Pointeur vers un rapport HID.
[in] ReportLength
Spécifie la taille, en octets, du rapport HID situé à Rapport, qui doit être égale à la longueur du rapport pour le type de rapport spécifié qui HidP_GetCaps retourne dans la structure HIDP_CAPS d’une collection.
Valeur de retour
HidP_SetScaledUsageValue retourne l’une des valeurs d’état suivantes :
| Retourner le code | Description |
|---|---|
| HIDP_STATUS_SUCCESS | La routine définit correctement la valeur d’utilisation. |
| HIDP_STATUS_BAD_LOG_PHY_VALUES | L’utilisation a une plage logique ou physique illégale qui empêche la mise à l’échelle. |
| HIDP_STATUS_VALUE_OUT_OF_RANGE | La valeur physique spécifiée est hors limites et l’utilisation n’a pas de valeur Null. |
| HIDP_STATUS_INVALID_REPORT_LENGTH | La longueur du rapport n’est pas valide. |
| HIDP_STATUS_INVALID_REPORT_TYPE | Le type de rapport spécifié n’est pas valide. |
| HIDP_STATUS_INCOMPATIBLE_REPORT_ID | L’utilisation n’existe pas dans le rapport spécifié, mais elle existe dans un autre rapport du type spécifié. |
| HIDP_STATUS_INVALID_PREPARSED_DATA | Les données prédéfinies ne sont pas valides. |
| HIDP_STATUS_USAGE_NOT_FOUND | L’utilisation n’existe pas dans un rapport du type de rapport spécifié. |
| HIDP_STATUS_NULL | La valeur physique spécifiée est hors limites, l’utilisation a une valeur Null et la routine définit la valeur Null. |
Remarques
Les valeurs mises à l’échelle font référence à la sortie ajustée des données HID brutes, qui sont modifiées en fonction de paramètres spécifiques tels que la sensibilité et la plage de l’appareil. Cet ajustement permet une interprétation plus significative des données par rapport à l’utilisation prévue de l’appareil.
Pour mieux comprendre comment les rapports HID sont interprétés et l’importance des valeurs mises à l’échelle, consultez 'interprétation des rapports HID.
HidP_SetScaledUsageValue définit le bit de signe.
Si la routine retourne HIDP_STATUS_INCOMPATIBLE_REPORT_ID, le rapport spécifié contient l’utilisation. Toutefois, une application en mode utilisateur ou un pilote en mode noyau peut définir l’utilisation dans un rapport initialisé zéro. Consultez initialisation des rapports HID.
Pour plus d’informations, consultez collections HID.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | hidpi.h (include Hidpi.h) |
| bibliothèque | Hidparse.lib |
| IRQL | <= DISPATCH_LEVEL |