HidP_SetScaledUsageValue-Funktion (hidpi.h)

Artikel
02/29/2024

Die HidP_SetScaledUsageValue Routine konvertiert eine signierte und skalierte physische Zahl in den Logischen Wert einer 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 Enumeratorwert an, der den Typ des HID-Berichts angibt, der sich unter Bericht befindet.

[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 in dieser Linkauflistung fest, sofern vorhanden. Wenn LinkCollection null ist, legt die Routine die erste Verwendung fest, die sie in der Auflistung der obersten Ebene findet, die PreparsedData zugeordnet ist.

[in] Usage

Gibt die Verwendung an.

[in] UsageValue

Gibt die signierte und skalierte physische Zahl an, die von der Routine in den Logischen Wert der Verwendung konvertiert wird.

[in] PreparsedData

Zeiger auf die vorbereiteten Daten einer obersten Ebene.

[in, out] Report

Zeiger auf einen HID-Bericht.

[in] ReportLength

Gibt die Größe des HID-Berichts in Byte an, der sich unter Bericht befindet, die der Berichtslänge für den angegebenen Berichtstyp entsprechen muss, der HidP_GetCaps in der HIDP_CAPS-Struktur einer Auflistung zurückgibt.

Rückgabewert

HidP_SetScaledUsageValue gibt einen der folgenden status Werte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Die Routine hat den Nutzungswert 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, aber sie ist in einem anderen Bericht des angegebenen Typs vorhanden.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die vorbereiteten 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 NULL-Wert fest.

Hinweise

HidP_SetScaledUsageValue legt das Zeichenbit fest.

Wenn die Routine HIDP_STATUS_INCOMPATIBLE_REPORT_ID zurückgibt, enthält der angegebene Bericht die Verwendung. Eine Benutzermodusanwendung oder ein Kernelmodustreiber kann jedoch die Verwendung in einem nullinitialisierten Bericht festlegen. Weitere Informationen finden Sie unter Initialisieren von HID-Berichten.

Weitere Informationen finden Sie unter HID-Auflistungen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform	Universell
Header	hidpi.h (hidpi.h einschließen)
Bibliothek	Hidparse.lib
IRQL	<= DISPATCH_LEVEL