Freigeben über

HidP_SetScaledUsageValue-Funktion (hidpi.h)

  • Artikel

Die HidP_SetScaledUsageValue Routine konvertiert eine signierte und skalierte physische Zahl in den Wahrheitswert der HID-Verwendung und legt den Verwendungswert in einem angegebenen HID-Bericht fest.

Syntax

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
);

Parameter

[in] ReportType

Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Typ des HID-Berichts angibt, der sich in Reportbefindet.

[in] UsagePage

Gibt die Verwendungsseite einer Verwendung an.

[in] LinkCollection

Gibt die Linkauflistung an, die die Verwendung enthält. Wenn LinkCollection- ungleich Null ist, legt die Routine nur die Verwendung fest, sofern vorhanden, in dieser Linkauflistung. Wenn LinkCollection- null ist, legt die Routine die erste Verwendung fest, die in der Auflistung der obersten Ebene zugeordnet PreparsedData-.

[in] Usage

Gibt die Verwendung an.

[in] UsageValue

Gibt die signierte und skalierte physische Zahl an, die die Routine in den Wahrheitswert der Verwendung konvertiert.

[in] PreparsedData

Zeiger auf die vordefinierten Daten auf oberster Ebene.

[in, out] Report

Zeiger auf einen HID-Bericht.

[in] ReportLength

Gibt die Größe des HID-Berichts in Bytes an, der sich in Reportbefindet, der der Berichtslänge für den angegebenen Berichtstyp entspricht HidP_GetCaps, der in der HIDP_CAPS Struktur einer Auflistung zurückgegeben wird.

Rückgabewert

HidP_SetScaledUsageValue gibt einen der folgenden Statuswerte zurück:

Rückgabecode Beschreibung
HIDP_STATUS_SUCCESS Die Routine hat den Verwendungswert erfolgreich festgelegt.
HIDP_STATUS_BAD_LOG_PHY_VALUES Die Verwendung weist einen unzulässigen logischen oder physischen Bereich auf, der die Skalierung verhindert.
HIDP_STATUS_VALUE_OUT_OF_RANGE Der angegebene physische Wert liegt außerhalb des Bereichs, und die Verwendung hat keinen NULL-Wert.
HIDP_STATUS_INVALID_REPORT_LENGTH Die Berichtslänge ist ungültig.
HIDP_STATUS_INVALID_REPORT_TYPE Der angegebene Berichtstyp ist ungültig.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID Die Verwendung ist im angegebenen Bericht nicht vorhanden, ist aber in einem anderen Bericht des angegebenen Typs vorhanden.
HIDP_STATUS_INVALID_PREPARSED_DATA Die analysierten Daten sind ungültig.
HIDP_STATUS_USAGE_NOT_FOUND Die Verwendung ist in keinem Bericht des angegebenen Berichtstyps vorhanden.
HIDP_STATUS_NULL Der angegebene physische Wert liegt außerhalb des Bereichs, die Verwendung hat einen NULL-Wert, und die Routine legt den Nullwert fest.

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.

HidP_SetScaledUsageValue legt das Zeichenbit fest.

Wenn die Routine HIDP_STATUS_INCOMPATIBLE_REPORT_ID zurückgibt, enthält der angegebene Bericht die Verwendung. Ein Benutzermodusanwendungs- oder Kernelmodustreiber kann die Verwendung jedoch in einem zero-initialisierten Bericht festlegen. Siehe Initialisieren von HID-Berichten.

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

Siehe auch