HidD_SetFeature-Funktion (hidsdi.h)

Die HidD_SetFeature Routine sendet einen Featurebericht an eine Sammlung auf oberster Ebene.

Syntax

BOOLEAN HidD_SetFeature(
  [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 Featureberichtpuffer, den der Aufrufer zum Angeben einer HID-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 Featurebericht 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_SetFeature 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 den FeatureReportByteLength Member der HIDP_CAPS Struktur einer Auflistung auf oberster Ebene angegeben, die von HidP_GetCaps Aufruf zurückgegeben wird.

Bevor die HidD_SetFeature 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 Featurebericht 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_SetFeatureaufrufen. Kernelmodustreiber können eine IOCTL_HID_SET_FEATURE Anforderung verwenden.

Anforderungen

Siehe auch

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