función HidP_InitializeReportForID (hidpi.h)
La rutina HidP_InitializeReportForID inicializa un informe HID.
NTSTATUS HidP_InitializeReportForID(
[in] HIDP_REPORT_TYPE ReportType,
[in] UCHAR ReportID,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[out] PCHAR Report,
[in] ULONG ReportLength
);
[in] ReportType
Especifica un enumerador de HIDP_REPORT_TYPE que indica el tipo de informe HID ubicado en Informe.
[in] ReportID
Especifica un identificador de informe.
[in] PreparsedData
Puntero al de datos preparados de la colección de nivel superior de asociada al informe HID ubicado en Report.
[out] Report
Puntero al búfer asignado por el autor de la llamada que contiene el informe HID que HidP_InitializeReportForID inicializa.
[in] ReportLength
Especifica el tamaño, en bytes, del informe HID ubicado en Informe. ReportLength debe ser igual a la longitud del informe de la colección para el tipo de informe especificado, tal y como especifica la XxxReportByteLength miembros de la estructura HIDP_CAPS de una colección.
HidP_InitializeReportForID devuelve uno de los siguientes valores de estado:
Código devuelto | Descripción |
---|---|
|
El informe se inicializó correctamente. |
|
Los datos preparados no son válidos. |
|
La longitud especificada del informe no es igual a la longitud del informe de la colección para el tipo de informe especificado. |
|
El tipo de informe no es válido. |
|
El identificador de informe especificado no es válido. |
Inicializar un informe HID establece todos los datos de control en cero o el valor null de un control, tal como se define en el estándar USB HID. (Enviar o recibir un valor NULL indica que no se debe modificar el valor actual de un control).
HidP_InitializeReportForID hace lo siguiente:
- Establece en cero los campos de bits de todos los botones y valores sin valores NULL.
- Establece el campo de bits de todos los controles con valores NULL en su valor NULL correspondiente.
Requisito | Valor |
---|---|
cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores de Windows. |
de la plataforma de destino de | Universal |
encabezado de | hidpi.h (incluya Hidpi.h) |
biblioteca de | Hidparse.lib |
irQL | <= DISPATCH_LEVEL |