HidP_InitializeReportForID-Funktion (hidpi.h)

Artikel
02/07/2025

Die HidP_InitializeReportForID Routine initialisiert einen HID-Bericht.

Syntax

NTSTATUS HidP_InitializeReportForID(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  UCHAR                ReportID,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [out] PCHAR                Report,
  [in]  ULONG                ReportLength
);

Parameter

[in] ReportType

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

[in] ReportID

Gibt eine Berichts-ID an.

[in] PreparsedData

Zeiger auf die analysierten Daten der Auflistung auf oberster Ebene dem HID-Bericht zugeordnet, der sich in Reportbefindet.

[out] Report

Zeigen Sie auf den vom Aufrufer zugewiesenen Puffer, der den HID-Bericht enthält, der initialisiert HidP_InitializeReportForID.

[in] ReportLength

Gibt die Größe des HID-Berichts in Bytes an, der sich in Reportbefindet. ReportLength- muss der Berichtslänge der Auflistung für den angegebenen Berichtstyp entsprechen, wie durch die XxxReportByteLength Elemente der HIDP_CAPS Struktur einer Auflistung angegeben.

Rückgabewert

HidP_InitializeReportForID gibt einen der folgenden Statuswerte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Der Bericht wurde erfolgreich initialisiert.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die analysierten Daten sind ungültig.
HIDP_STATUS_INVALID_REPORT_LENGTH	Die angegebene Länge des Berichts entspricht nicht der Berichtslänge der Auflistung für den angegebenen Berichtstyp.
HIDP_STATUS_INVALID_REPORT_TYPE	Der Berichtstyp ist ungültig.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Die angegebene Berichts-ID ist ungültig.

Bemerkungen

Beim Initialisieren eines HID-Berichts werden alle Steuerelementdaten auf Null oder den Nullwert eines Steuerelementsfestgelegt, wie durch den USB-HID-Standard definiert. (Das Senden oder Empfangen eines Nullwerts gibt an, dass der aktuelle Wert eines Steuerelements nicht geändert werden soll.)

HidP_InitializeReportForID führt folgende Aktionen aus:

Legt null die Bitfelder aller Schaltflächen und Werte ohne Nullwerte fest.
Legt das Bitfeld aller Steuerelemente mit NULL-Werten auf den entsprechenden Nullwert fest.

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

Freigeben über