HidP_GetValueCaps-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_GetValueCaps Routine gibt ein Wertefunktionsarray zurück, das alle HID-Steuerelementwerte in einer Auflistung auf oberster Ebene für einen bestimmten HiD-Berichttyp beschreibt.

Syntax

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Parameter

[in] ReportType

Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Berichtstyp identifiziert.

[out] ValueCaps

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, in dem die Routine ein Wertefunktionsarray für den angegebenen Berichtstyp zurückgibt.

[in, out] ValueCapsLength

Gibt die Länge des ValueCaps-Puffers für eingaben in Arrayelementen an. Bei der Ausgabe legt die Routine ValueCapsLength- auf die Anzahl der Elemente fest, die sie tatsächlich zurückgibt.

[in] PreparsedData

Zeiger auf die vordefinierten Daten einer Auflistung auf oberster Ebene.

Rückgabewert

HidP_GetValueCaps gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Die Routine hat die Funktionsdaten erfolgreich zurückgegeben.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die analysierten Daten sind ungültig.

Bemerkungen

Die richtige Länge für ValueCapsLength- wird durch die NumberXxxValueCaps Member der HIDP_CAPS-Struktur einer Auflistung auf oberster Ebene angegeben.

Weitere Informationen zur Funktion einer Sammlung finden Sie unter Abrufen von Sammlungsinformationen.

Siehe auch 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

Freigeben über