HidD_GetFeature-Funktion (hidsdi.h)

  • Artikel

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:

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

Weitere Informationen