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 |
---|---|
|
Die Routine hat den Verwendungswert erfolgreich festgelegt. |
|
Die Verwendung ist im angegebenen Bericht nicht vorhanden, ist aber in einem anderen Bericht des angegebenen Typs vorhanden. |
|
Die analysierten Daten sind ungültig. |
|
Es gibt keine Berichte des angegebenen Typs. |
|
Die Verwendung ist in keinem Bericht des angegebenen Berichtstyps vorhanden. |
|
Die Berichtslänge ist ungültig. |
|
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 |