HidP_GetData-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_GetData Routine gibt für einen angegebenen Bericht ein Array von HIDP_DATA Strukturen zurück, die die Datenindizes aller HID-Steuerelementschaltflächen identifizieren, die derzeit auf EIN (1) festgelegt sind, sowie die Datenindizes und Daten, die allen HID-Steuerelementwerten zugeordnet sind.

Syntax

NTSTATUS HidP_GetData(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_DATA           DataList,
  [in, out] PULONG               DataLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

Parameter

[in] ReportType

Gibt einen HIDP_REPORT_TYPE Enumerationswert an, der den Typ des HID-Berichts angibt, der sich in Reportbefindet.

[out] DataList

Gibt ein aufrufergeteilte Array von HIDP_DATA Strukturen an, die von der Routine verwendet werden, um Informationen zu allen Schaltflächen zurückzugeben, die derzeit auf EIN festgelegt sind, und die Daten, die Werten zugeordnet sind.

[in, out] DataLength

Gibt bei eingaben die Anzahl der Strukturen an, die der vom Aufrufer zugewiesene DataList- Array enthält. Gibt bei der Ausgabe die Anzahl der Steuerelemente an, für die die Routine Daten zurückgeben kann, einschließlich aller Schaltflächen, die derzeit auf EIN und alle Steuerelementwerte festgelegt sind.

[in] PreparsedData

Zeigen Sie auf die analysierten Daten der Auflistung der obersten Ebene, die dem HID-Bericht zugeordnet ist, der sich in Reportbefindet.

[in] Report

Zeiger auf einen HID-Bericht.

[in] ReportLength

Gibt die Größe des HID-Berichts in Byte an, der sich in Reportbefindet, der der Berichtslänge für den angegebenen Berichtstyp entsprechen muss, der von HidP_GetCaps in der HIDP_CAPS-Struktur der Auflistung zurückgegeben wird.

Rückgabewert

HidP_GetData gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Alle Steuerelementdaten wurden erfolgreich zurückgegeben.
HIDP_STATUS_INVALID_REPORT_TYPE	Der durch ReportType- angegebene Berichtstyp ist ungültig.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die durch PreparsedData- angegebenen vordefinierten Daten sind ungültig.
HIDP_STATUS_INVALID_REPORT_LENGTH	Die Größe des HID-Berichts in Bytes entspricht nicht der Länge, die in der HIDP_CAPS Struktur der Auflistung für den angegebenen Berichtstyp angegeben ist.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Die Auflistung auf oberster Ebene verfügt nicht über einen Bericht des angegebenen Typs.
HIDP_STATUS_BUFFER_TOO_SMALL	Das DataList- Arrays ist zu klein, um alle Schaltflächen zu beschreiben, die derzeit auf EIN festgelegt sind, und alle Werte im HID-Bericht.

Bemerkungen

Benutzermodusanwendungen und Kernelmodustreiber rufen HidP_MaxDataListLength auf, um die maximale Anzahl von HIDP_DATA Strukturen zu ermitteln, die HidP_GetData zurückgeben können.

HidP_GetData gibt keine Daten für Verwendungswertarrayszurück.

Weitere Informationen finden Sie unter 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

HIDP_DATA

HidP_MaxDataListLength

HidP_SetData

_HIDP_PREPARSED_DATA

Freigeben über