HidD_GetFeature-Funktion (hidsdi.h)

Artikel
02/26/2024

Die HidD_GetFeature Routine gibt einen Featurebericht aus einer angegebenen Auflistung der obersten Ebene zurück.

Syntax

BOOLEAN HidD_GetFeature(
  [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

Zeiger auf einen vom Aufrufer zugewiesenen HID-Berichtspuffer, den der Aufrufer verwendet, um eine Berichts-ID anzugeben. HidD_GetFeature verwendet ReportBuffer , um den angegebenen Featurebericht zurückzugeben.

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_GetFeature 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_GetFeature-Routine aufgerufen wird, muss der Aufrufer Folgendes tun:

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 der obersten Ebene keine Berichts-IDs enthält, muss der Aufrufer das erste Byte des ReportBuffer-Parameters auf 0 festlegen.

Der Featurebericht wird im ReportBuffer-Parameter zurückgegeben. Abhängig von der Berichts-ID analysiert der Aufrufer den Bericht, indem er eine der folgenden Funktionen aufruft:

Ein Beispiel zum Analysieren eines HID-Berichts finden Sie in der HClient-Beispielanwendung . Dieses Beispiel befindet sich in der MSDN Code Gallery.

Nur Anwendungen im Benutzermodus können HidD_GetFeature aufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_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

Freigeben über