funzione HidD_SetOutputReport (hidsdi.h)
La routine HidD_SetOutputReport invia un report di output a una raccolta di livello superiore.
Usare questa routine solo per impostare lo stato corrente di una raccolta. Alcuni dispositivi potrebbero non supportare questa routine e diventeranno non rispondenti se questa routine viene usata. Per altre informazioni, vedere Invio di report HID da User-Mode applicazioni.
Sintassi
BOOLEAN HidD_SetOutputReport(
[in] HANDLE HidDeviceObject,
[in] PVOID ReportBuffer,
[in] ULONG ReportBufferLength
);
Parametri
[in] HidDeviceObject
Handle aperto a una raccolta di primo livello.
[in] ReportBuffer
Puntatore a un buffer di report di output allocato dal chiamante usato dal chiamante per specificare un ID report.
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 di output 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_SetOutputReport 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 OutputReportByteLength di una struttura HIDP_CAPS di livello superiore restituita dalla chiamata HidP_GetCaps.
Prima di chiamare la routine HidD_SetOutputReport , 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 di output viene fatto riferimento al parametro ReportBuffer . A seconda dell'ID del report, il chiamante prepara il report chiamando una delle funzioni seguenti:
Per un esempio di come preparare e inviare un report HID a una raccolta di livello superiore, vedere l'applicazione di esempio HClient .
Solo le applicazioni in modalità utente possono chiamare HidD_SetOutputReport. I driver in modalità kernel possono usare una richiesta di IOCTL_HID_SET_OUTPUT_REPORT .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows XP e versioni successive di Windows. |
| Piattaforma di destinazione | Universale |
| Intestazione | hidsdi.h (include Hidsdi.h) |
| Libreria | Hid.lib |
| DLL | Hid.dll |