HidP_SetUsageValue-Funktion (hidpi.h)

Die HidP_SetUsageValue Routine legt einen HID-Steuerelementwert in einem angegebenen HID-Bericht fest.

Syntax

NTSTATUS HidP_SetUsageValue(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      ULONG                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 den Verwendungswert an.

[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 entsprechen muss HidP_GetCaps, der in der HIDP_CAPS Struktur einer Auflistung zurückgegeben wird.

Rückgabewert

HidP_SetUsageValue gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Die Routine hat den Verwendungswert erfolgreich festgelegt.
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_REPORT_DOES_NOT_EXIST	Es gibt keine Berichte des angegebenen Typs.
HIDP_STATUS_USAGE_NOT_FOUND	Die Verwendung ist in keinem Bericht des angegebenen Berichtstyps vorhanden.
HIDP_STATUS_INVALID_REPORT_LENGTH	Die Berichtslänge ist ungültig.
HIDP_STATUS_INVALID_REPORT_TYPE	Der angegebene Berichtstyp ist ungültig.

Bemerkungen

HidP_SetUsageValue Routine signiert den Wert nicht. Eine Benutzermodusanwendung oder ein Kernelmodustreiber muss entweder den Wert signieren, an der Position, die in der HIDP_VALUE_CAPS Struktur für diesen Wert angegeben ist, oder HidP_SetScaledUsageValueaufrufen.

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

HIDP_VALUE_CAPS

HidP_SetScaledUsageValue

_HIDP_PREPARSED_DATA