HidP_GetSpecificValueCaps-Funktion (hidpi.h)

Artikel
02/26/2024

Die HidP_GetSpecificValueCaps Routine gibt ein Wertfunktionsarray 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 Enumeratorwert an, der den Berichtstyp identifiziert.

[in] UsagePage

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

[in] LinkCollection

Gibt eine Linksammlung als Suchkriterium an. Wenn LinkCollection ungleich null ist, werden nur Werte zurückgegeben, die Teil dieser Linkauflistung sind.

[in] Usage

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

[out] ValueCaps

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

[in, out] ValueCapsLength

Gibt die Länge für die Eingabe in Arrayelementen des Puffers an, der unter 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

Zeiger auf die vorbereiteten Daten einer Sammlung auf oberster Ebene.

Rückgabewert

HidP_GetSpecificValueCaps gibt einen der folgenden status Werte 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 vorbereiteten Daten sind ungültig.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	Die Verwendung ist in keinem Bericht des angegebenen Berichtstyps vorhanden.

Hinweise

Die erforderliche Größe des ValueCaps-Puffers wird von den NumberXxxValueCaps-Membern der HIDP_CAPS-Struktur einer Auflistung der obersten Ebene angegeben.

Beim Aufrufen HidP_GetSpecificValueCaps entspricht die Angabe von null für UsagePage, Usage und LinkCollection dem Aufrufen HidP_GetValueCaps.

Weitere Informationen zu den Funktionen einer Sammlung finden Sie unter Abrufen von Sammlungsinformationen.

Siehe auch HID-Sammlungen.

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	PASSIVE_LEVEL

Weitere Informationen