HidP_GetSpecificValueCaps-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_GetSpecificValueCaps Routine gibt ein Wertefunktionsarray zurück, das alle HID-Steuerelementwerte beschreibt, die einem angegebenen Auswahlkriterium entsprechen.

Syntax

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [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.

[in] UsagePage

Gibt eine Verwendungsseite als Suchkriterien an. Wenn UsagePage- nicht null ist, werden nur Werte zurückgegeben, die diese Verwendungsseite angeben.

[in] LinkCollection

Gibt eine Linkauflistung als Suchkriterien an. Wenn LinkCollection- ungleich Null ist, werden nur Werte zurückgegeben, die Teil dieser Linkauflistung sind.

[in] Usage

Gibt eine HID-Verwendung als Suchkriterien an. Wenn Usage ungleich Null ist, werden nur Werte zurückgegeben, die diese Verwendung angeben.

[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 der Eingabe in Arrayelementen des Puffers an, der bei ValueCaps-bereitgestellt wird. Bei der Ausgabe wird dieser Parameter auf die Anzahl der Elemente festgelegt, die von der Routine tatsächlich zurückgegeben werden.

[in] PreparsedData

Zeigen Sie auf die vordefinierten DateneinerAuflistung auf oberster Ebene.

Rückgabewert

HidP_GetSpecificValueCaps gibt einen der folgenden Statuswerte zurück:

Rückgabecode	NT-Statuswert	Beschreibung
HIDP_STATUS_SUCCESS	0x00110000	Die Routine hat die Funktionsdaten erfolgreich zurückgegeben.
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	Die analysierten Daten sind ungültig.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	Die Verwendung ist in keinem Bericht des angegebenen Berichtstyps vorhanden.

Bemerkungen

Die erforderliche Größe des ValueCaps- Puffers wird durch die NumberXxxValueCaps Member der HIDP_CAPS-Struktur einer Auflistung auf oberster Ebene angegeben.

Beim Aufrufen von HidP_GetSpecificValueCapsentspricht das Angeben von Null für UsagePage, Usageund LinkCollection- dem Aufrufen von HidP_GetValueCaps.

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-	PASSIVE_LEVEL

Siehe auch

Freigeben über