HidP_InitializeReportForID-Funktion (hidpi.h)

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:

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.

Anforderungen

Siehe auch

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA