HidP_GetScaledUsageValue-Funktion (hidpi.h)
Die HidP_GetScaledUsageValue Routine gibt das signierte und skalierte Ergebnis eines HID-Steuerelementwerts zurück, der aus einem HID-Bericht extrahiert wurde.
Syntax
NTSTATUS HidP_GetScaledUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[out] PLONG UsageValue,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in] PCHAR Report,
[in] ULONG ReportLength
);
Parameter
[in] ReportType
Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Typ des HID-Berichts identifiziert, der den HID-Verwendungswert enthält.
[in] UsagePage
Gibt die Verwendungsseite des zu extrahierenden Werts an.
[in] LinkCollection
Gibt den Linkauflistungsbezeichner des zu extrahierenden Werts an. Ein LinkCollection-Wert von Null identifiziert die Sammlung der obersten Ebene.
[in] Usage
Gibt die Verwendung des zu extrahierenden Werts an.
[out] UsageValue
Zeigen Sie auf den Puffer, in dem die Routine den signierten und skalierten Wert zurückgibt.
[in] PreparsedData
Zeiger auf die analysierten Daten der Auflistung auf oberster Ebene, die den Bericht generiert hat, der sich auf Reportbefindet.
[in] Report
Zeigen Sie auf den Bericht, der die Verwendung enthält.
[in] ReportLength
Gibt die Länge des Berichts in Bytes an, der sich in Reportbefindet.
Rückgabewert
HidP_GetScaledUsageValue gibt einen der folgenden Statuswerte zurück:
| Rückgabecode | Beschreibung |
|---|---|
| HIDP_STATUS_SUCCESS | Die Routine hat den Wert erfolgreich zurückgegeben. |
| HIDP_STATUS_INVALID_REPORT_TYPE | Der angegebene Berichtstyp ist ungültig. |
| HIDP_STATUS_INVALID_REPORT_LENGTH | Die angegebene Berichtslänge ist ungültig. |
| HIDP_STATUS_BAD_LOG_PHY_VALUES | Die Auflistung hat einen ungültigen logischen oder physischen Wert zurückgegeben. Rufen Sie HidP_GetUsageValueauf, um den von der Auflistung zurückgegebenen Wert zu extrahieren. |
| HIDP_STATUS_NULL | Der aktuelle Zustand des skalierten Werts aus der Auflistung ist kleiner als das logische Minimum oder größer als das logische Maximum, und der skalierte Wert weist einen NULL- Zustand auf. |
| HIDP_STATUS_VALUE_OUT_OF_RANGE | Der aktuelle Status der Daten für skalierte Werte aus der Auflistung ist kleiner als das logische Minimum oder größer als das logische Maximum. |
| HIDP_STATUS_USAGE_NOT_FOUND | Die angegebene Verwendungs-, Verwendungsseite oder Linksammlung kann in keinem Bericht gefunden werden, der von der angegebenen Sammlung auf oberster Ebene unterstützt wird. |
| HIDP_STATUS_INCOMPATIBLE_REPORT_ID | Der angegebene Wert ist nicht im angegebenen Bericht enthalten, sondern in einem anderen Bericht enthalten, der von der angegebenen Auflistung auf oberster Ebene unterstützt wird. |
Bemerkungen
Skalierte Werte beziehen sich auf die angepasste Ausgabe von HID-Rohdaten, die basierend auf bestimmten Parametern wie Empfindlichkeit und Bereich des Geräts geändert werden. Diese Anpassung ermöglicht eine aussagekräftigere Interpretation der Daten in Bezug auf die beabsichtigte Verwendung des Geräts.
Weitere Informationen zur Interpretation von HID-Berichten und zur Bedeutung skalierter Werte finden Sie unter Interpretieren von HID-Berichten.
Die in PreparsedData, UsageValueund Report bereitgestellten Aufruferpuffer müssen aus einem nicht seitengebundenen Pool zugeordnet werden.
Benutzermodusanwendungen und Kernelmodustreiber müssen HidP_GetUsageValueArray verwenden, um Daten für ein Nutzungswertarrayzu extrahieren.
Wenn die Routine den Status HIDP_STATUS_BAD_LOG_PHY_VALUES zurückgibt, kann eine Anwendung oder ein Treiber HidP_GetUsageValue aufrufen, um die rohen Nutzungsdaten zu extrahieren.
Weitere Informationen finden Sie unter HID Collections.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Universal |
| Header- | hidpi.h (include Hidpi.h) |
| Library | Hidparse.lib |
| IRQL- | <= DISPATCH_LEVEL |