funzione HidP_InitializeReportForID (hidpi.h)

La routine HidP_InitializeReportForID inizializza un report HID.

Sintassi

NTSTATUS HidP_InitializeReportForID(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  UCHAR                ReportID,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [out] PCHAR                Report,
  [in]  ULONG                ReportLength
);

Parametri

[in] ReportType

Specifica un enumeratore HIDP_REPORT_TYPE che indica il tipo di report HID disponibile in Report.

[in] ReportID

Specifica un ID report.

[in] PreparsedData

Puntatore al prepara i dati della raccolta di di primo livello associata al report HID che si trova in Report.

[out] Report

Puntatore al buffer allocato dal chiamante contenente il report HID che HidP_InitializeReportForID inizializza.

[in] ReportLength

Specifica le dimensioni, in byte, del report HID che si trova in Report. reportLength deve essere uguale alla lunghezza del report della raccolta per il tipo di report specificato, come specificato dal XxxReportByteLength membri della struttura HIDP_CAPS di una raccolta.

Valore restituito

HidP_InitializeReportForID restituisce uno dei valori di stato seguenti:

Osservazioni

L'inizializzazione di un report HID imposta tutti i dati di controllo su zero o il valore null di un controllo , come definito dallo standard USB HID. L'invio o la ricezione di un valore Null indica che il valore corrente di un controllo non deve essere modificato.

HidP_InitializeReportForID esegue le operazioni seguenti:

• Imposta su zero i campi di bit di tutti i pulsanti e i valori senza valori Null.
• Imposta il campo di bit di tutti i controlli con valori Null sul valore Null corrispondente.

Fabbisogno

Vedere anche

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA