HidD_SetOutputReport-Funktion (hidsdi.h)

Die HidD_SetOutputReport Routine sendet einen Ausgabebericht an eine Sammlung auf oberster Ebene.

Verwenden Sie diese Routine nur, um den aktuellen Status einer Auflistung festzulegen. Einige Geräte unterstützen diese Routine möglicherweise nicht und reagieren nicht mehr, wenn diese Routine verwendet wird. Weitere Informationen finden Sie unter Senden von HID-Berichten durch User-Mode Anwendungen.

Syntax

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

Parameter

[in] HidDeviceObject

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

[in] ReportBuffer

Zeigen Sie auf einen vom Aufrufer zugewiesenen Ausgabeberichtpuffer, den der Aufrufer zum Angeben einer Berichts-ID verwendet.

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 Ausgabebericht sowie ein zusätzliches Byte zu enthalten, das eine Nichtzero-Berichts-ID angibt. Wenn keine Berichts-ID verwendet wird, ist der ID-Wert null.

Rückgabewert

Wenn HidD_SetOutputReport erfolgreich ist, wird TRUE-zurückgegeben; andernfalls wird FALSE-zurückgegeben. Verwenden Sie GetLastError-, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

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

Bevor die HidD_SetOutputReport 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.
• Auf den Ausgabebericht wird vom ReportBuffer Parameter verwiesen. Je nach Berichts-ID bereitet der Aufrufer den Bericht durch Aufrufen einer der folgenden Funktionen vor:
  • HidP_SetData
  • HidP_SetScaledUsageValue
  • HidP_SetUsages
  • HidP_SetUsageValue
  • HidP_SetUsageValueArray

Ein Beispiel zum Vorbereiten und Senden eines HID-Berichts an eine Auflistung auf oberster Ebenefinden Sie in der HClient- Beispielanwendung.

Nur Benutzermodusanwendungen können HidD_SetOutputReportaufrufen. Kernelmodustreiber können eine IOCTL_HID_SET_OUTPUT_REPORT Anforderung verwenden.

Anforderungen

Siehe auch

• Senden von HID-Berichten
• Interpretieren von HID-Berichten
• HidD_GetFeature
• HidD_GetInputReport
• HidD_SetFeature
• HIDP_CAPS
• HidP_GetCaps
• IOCTL_HID_GET_FEATURE
• IOCTL_HID_GET_INPUT_REPORT
• IOCTL_HID_SET_FEATURE
• IOCTL_HID_SET_OUTPUT_REPORT