Freigeben über

HidD_GetFeature-Funktion (hidsdi.h)

Die HidD_GetFeature Routine gibt einen Featurebericht aus einer angegebenen Auflistung auf oberster Ebenezurü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

Zeigen Sie auf einen vom Aufrufer zugewiesenen HID-Berichtspuffer, den der Aufrufer zum Angeben einer Berichts-ID verwendet. 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 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_GetFeature 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_GetFeature 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.

Der Featurebericht wird im ReportBuffer--Parameter zurückgegeben. Je nach Berichts-ID analysiert der Aufrufer den Bericht durch Aufrufen einer der folgenden Funktionen:

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

Nur Benutzermodusanwendungen können HidD_GetFeatureaufrufen. Kernelmodustreiber können eine IOCTL_HID_GET_FEATURE Anforderung verwenden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows 2000 und höheren Versionen von Windows.
Zielplattform- Universal
Header- hidsdi.h (include Hidsdi.h)
Library Hid.lib
DLL- Hid.dll

Siehe auch

  • Last updated on