Condividi tramite

funzione HidD_SetFeature (hidsdi.h)

  • Articolo

La routine HidD_SetFeature invia un report delle funzionalità a una raccolta di di primo livello.

Sintassi

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

Parametri

[in] HidDeviceObject

Handle aperto per una raccolta di primo livello.

[in] ReportBuffer

Puntatore a un buffer di report delle funzionalità allocato dal chiamante usato dal chiamante per specificare un ID report HID.

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 sufficientemente grande da 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_SetFeature ha esito positivo, restituisce TRUE; in caso contrario, restituisce FALSE. Usare GetLastError per ottenere informazioni estese sull'errore.

Osservazioni

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 HidD_SetFeature, il chiamante deve eseguire le operazioni seguenti:

Per un esempio di come preparare e inviare un report HID a una raccolta di di primo livello, vedere l'applicazione di esempio HClient.

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

Fabbisogno

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

Vedere anche