Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
Die Routine hat die Funktionsdaten erfolgreich zurückgegeben. |
|
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 |