Condividi tramite

funzione HidD_GetFeature (hidsdi.h)

  • Articolo

La routine HidD_GetFeature restituisce un report di funzionalità da una raccolta di livello superiore specificata.

Sintassi

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parametri

[in] HidDeviceObject

Handle aperto a una raccolta di primo livello.

[out] ReportBuffer

Puntatore a un buffer di report HID allocato dal chiamante che il chiamante usa per specificare un ID report. HidD_GetFeature usa ReportBuffer per restituire il report di funzionalità specificato.

Per altre informazioni su questo parametro, vedere la sezione Osservazioni .

[in] ReportBufferLength

Dimensioni del buffer del report in byte. Il buffer del report deve essere abbastanza grande per contenere il report delle funzionalità più un byte aggiuntivo che specifica un ID report diverso da zero. Se l'ID del report non viene usato, il valore ID è zero.

Valore restituito

Se HidD_GetFeature ha esito positivo, restituisce TRUE; in caso contrario, restituisce FALSE. Usare GetLastError per ottenere informazioni sull'errore estese.

Commenti

Il reportBufferLength corretto viene specificato dal membro FeatureReportByteLength di una struttura HIDP_CAPS di livello superiore restituita dalla chiamata HidP_GetCaps.

Prima di chiamare la routine di HidD_GetFeature , il chiamante deve eseguire le operazioni seguenti:

  • Se la raccolta di primo livello include ID report, il chiamante deve impostare il primo byte del parametro ReportBuffer su un ID report diverso da zero.
  • Se la raccolta di primo livello non include ID report, il chiamante deve impostare il primo byte del parametro ReportBuffer su zero.

Il report delle funzionalità viene restituito nel parametro ReportBuffer . A seconda dell'ID del report, il chiamante analizza il report chiamando una delle funzioni seguenti:

Per un esempio di come analizzare un report HID, vedere l'applicazione di esempio HClient . Questo esempio si trova in MSDN Code Gallery.

Solo le applicazioni in modalità utente possono chiamare HidD_GetFeature. I driver in modalità kernel possono usare una richiesta di IOCTL_HID_GET_FEATURE .

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione Universale
Intestazione hidsdi.h (include Hidsdi.h)
Libreria Hid.lib
DLL Hid.dll

Vedi anche