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 Aufzählungsator an, der den Typ des HID-Berichts angibt, der sich im Bericht befindet.

[in] ReportID

Gibt eine Berichts-ID an.

[in] PreparsedData

Zeiger auf die vordefinierten Daten der Sammlung der obersten Ebene, die dem HID-Bericht zugeordnet ist, der sich im Bericht befindet.

[out] Report

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

[in] ReportLength

Gibt die Größe des HID-Berichts in Bytes an, der sich im Bericht befindet. ReportLength muss der Berichtslänge der Auflistung für den angegebenen Berichtstyp entsprechen, wie durch die XxxReportByteLength-Member 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 vordefinierten 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 Steuerelements festgelegt, wie durch den USB-HID-Standard definiert. (Senden oder Empfangen eines Nullwerts gibt an, dass der aktuelle Wert eines Steuerelements nicht geändert werden soll.)

HidP_InitializeReportForID führt folgendes aus:

  • Legt auf 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-Auflistungen.

Requirements (Anforderungen)

   
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000- und höher-Versionen von Windows.
Zielplattform Universell
Header hidpi.h (include Hidpi.h)
Bibliothek Hidparse.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA