Freigeben über


HidD_SetFeature-Funktion (hidsdi.h)

Die HidD_SetFeature Routine sendet einen Featurebericht an eine Sammlung der obersten 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

Zeiger auf einen vom Aufrufer zugewiesenen Featureberichtspuffer, den der Aufrufer verwendet, um eine HID-Berichts-ID anzugeben.

Weitere Informationen zu diesem Parameter finden Sie im Abschnitt Hinweise .

[in] ReportBufferLength

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

Rückgabewert

Wenn HidD_SetFeature erfolgreich ist, wird TRUE zurückgegeben. Andernfalls wird FALSE zurückgegeben. Verwenden Sie GetLastError , um erweiterte Fehlerinformationen abzurufen.

Hinweise

Die richtige ReportBufferLength wird vom FeatureReportByteLength-Member der HIDP_CAPS Struktur einer Auflistung der obersten Ebene angegeben, die von HidP_GetCaps Aufruf zurückgegeben wird.

Bevor die HidD_SetFeature-Routine aufgerufen wird, muss der Aufrufer Folgendes ausführen:

Ein Beispiel zum Vorbereiten und Senden eines HID-Berichts an eine Sammlung der obersten Ebene finden Sie in der HClient-Beispielanwendung .

Nur Anwendungen im Benutzermodus können HidD_SetFeature aufrufen. Kernelmodustreiber können eine IOCTL_HID_SET_FEATURE Anforderung verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform Universell
Header hidsdi.h (include Hidsdi.h)
Bibliothek Hid.lib
DLL Hid.dll

Weitere Informationen