Freigeben über

HidD_GetInputReport-Funktion (hidsdi.h)

  • Artikel

Die HidD_GetInputReport Routine gibt einen Eingabebericht aus einer Auflistung auf oberster Ebenezurück.

Verwenden Sie diese Routine nur, um den aktuellen Status einer Auflistung abzurufen. Wenn eine Anwendung versucht, diese Routine zum kontinuierlichen Abrufen von Eingabeberichten zu verwenden, können die Berichte verloren gehen. Weitere Informationen finden Sie unter Abrufen von HID-Berichten durch Benutzermodusanwendungen.

Syntax

BOOLEAN HidD_GetInputReport(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parameter

[in] HidDeviceObject

Ein geöffnetes Handle für eine Sammlung auf oberster Ebene.

[out] ReportBuffer

Zeigen Sie auf einen vom Aufrufer zugewiesenen Eingabeberichtpuffer, den der Aufrufer zum Angeben einer HID-Berichts-ID verwendet, und HidD_GetInputReport verwendet, um den angegebenen Eingabebericht zurückzugeben.

Weitere Informationen zu diesem Parameter finden Sie im Abschnitt "Hinweise".

[in] ReportBufferLength

Die Größe des Berichtspuffers in Byte. Der Berichtspuffer muss groß genug sein, um den Eingabebericht sowie ein zusätzliches Byte zu enthalten, das eine Berichts-ID angibt. Wenn keine Berichts-ID verwendet wird, ist der ID-Wert null.

Rückgabewert

HidD_GetInputReport gibt TRUE- zurück, wenn dies erfolgreich ist; andernfalls wird FALSE-zurückgegeben. Verwenden Sie GetLastError-, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Die richtige ReportBufferLength- wird durch den InputReportByteLength Member der HIDP_CAPS-Struktur einer Auflistung auf oberster Ebene angegeben, die von HidP_GetCaps Aufruf zurückgegeben wird.

Bevor die HidD_GetInputReport Routine aufgerufen wird, muss der Aufrufer folgendes ausführen:

  • Wenn die Auflistung der obersten Ebene Berichts-IDs enthält, muss der Aufrufer das erste Byte des ReportBuffer--Parameters auf eine Nichtzero-Berichts-ID festlegen.
  • Wenn die Auflistung auf oberster Ebene keine Berichts-IDs enthält, muss der Aufrufer das erste Byte des ReportBuffer Parameter auf Null festlegen.

Der Eingabebericht wird im ReportBuffer--Parameter zurückgegeben. Je nach Berichts-ID analysiert der Aufrufer den Bericht durch Aufrufen einer der folgenden Funktionen:

Ein Beispiel zum Analysieren eines HID-Berichts finden Sie in der beispielanwendung HClient.

Nur Benutzermodusanwendungen können HidD_GetInputReportaufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_INPUT_REPORTAnforderung verwenden.

Weitere Informationen finden Sie unter Interpretieren von HID-Berichten.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows XP und höheren Versionen von Windows.
Zielplattform- Universal
Header- hidsdi.h (include Hidsdi.h)
Library Hid.lib
DLL- Hid.dll

Siehe auch