Freigeben über


HidP_GetSpecificValueCaps-Funktion (hidpi.h)

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

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetCaps

HidP_GetValueCaps

_HIDP_PREPARSED_DATA