HidP_InitializeReportForID-Funktion (hidpi.h)

Artikel
02/26/2024

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 unter Bericht befindet.

[in] ReportID

Gibt eine Berichts-ID an.

[in] PreparsedData

Zeiger auf die vorbereiteten Daten der Sammlung der obersten Ebene, die dem HID-Bericht unter Bericht zugeordnet ist.

[out] Report

Zeiger 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 Byte an, der sich unter Bericht befindet. ReportLength muss gleich der Berichtslänge der Auflistung für den angegebenen Berichtstyp sein, wie in den XxxReportByteLength-Membern der HIDP_CAPS-Struktur einer Auflistung angegeben.

Rückgabewert

HidP_InitializeReportForID gibt einen der folgenden status-Werte zurück:

Rückgabecode	Beschreibung
HIDP_STATUS_SUCCESS	Der Bericht wurde erfolgreich initialisiert.
HIDP_STATUS_INVALID_PREPARSED_DATA	Die vorbereiteten 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.

Hinweise

Beim Initialisieren eines HID-Berichts werden alle Steuerungsdaten auf 0 oder den NULL-Wert eines Steuerelements festgelegt, wie im USB-HID-Standard definiert. (Das Senden oder Empfangen eines NULL-Werts gibt an, dass der aktuelle Wert eines Steuerelements nicht geändert werden soll.)

HidP_InitializeReportForID führt Folgendes aus:

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

Weitere Informationen finden Sie unter HID-Auflistungen.

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	<= DISPATCH_LEVEL

Weitere Informationen