función HidP_GetExtendedAttributes (hidpi.h)
La rutina HidP_GetExtendedAttributes devuelve los atributos extendidos de un control HID.
Sintaxis
NTSTATUS HidP_GetExtendedAttributes(
[in] HIDP_REPORT_TYPE ReportType,
[in] USHORT DataIndex,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[out] PHIDP_EXTENDED_ATTRIBUTES Attributes,
[in, out] PULONG LengthAttributes
);
Parámetros
[in] ReportType
Especifica un valor de enumerador HIDP_REPORT_TYPE que indica el tipo de informe HID asociado al control HID especificado por DataIndex.
[in] DataIndex
Especifica el índice de datos del control HID.
[in] PreparsedData
Especifica el de datos preparados para el de colección de nivel superior que contiene el control especificado.
[out] Attributes
Puntero a un búfer asignado por el autor de la llamada que usa la rutina para devolver los atributos extendidos del control especificado por DataIndex.
[in, out] LengthAttributes
Especifica el tamaño, en bytes, del búfer de atributos de (que debe ser mayor o igual que sizeof(HIDP_EXTENDED_ATTRIBUTES).
Valor devuelto
HidP_GetExtendedAttributes devuelve uno de los siguientes valores de estado:
| Código devuelto | Descripción |
|---|---|
|
La rutina devolvió correctamente toda la información de atributo extendida del control. |
|
El atributo búfer no era lo suficientemente grande como para contener toda la información del atributo extendido. |
|
El índice de datos especificado no es válido. |
Observaciones
HidP_GetExtendedAttributes devuelve una estructura HIDP_EXTENDED_ATTRIBUTES de longitud variable en el búfer de atributo de. La estructura de atributos extendidos contiene, en orden consecutivo, los miembros de longitud fija (NumGlobalUnknowns, Reservedy GlobalUnknowns) seguidos de una matriz de longitud variable de HIDP_UNKNOWN_TOKEN estructuras. El primer miembro de la matriz de tokens desconocida se encuentra en (PHIDP_UNKNOWN_TOKEN*)&(Atributos:>Data).
La rutina devuelve tantos bytes de la información del atributo extendido como el atributo búfer puede contener. Si el búfer es demasiado pequeño, la rutina trunca la información que devuelve. Para determinar el número de tokens desconocidos en la matriz de longitud variable, un autor de la llamada puede usar primero el búfer Atributos para devolver el valor del NumGlobalUnknowns miembro de la información de atributos extendidos.
Para obtener más información, consulte colecciones HID.
Requisitos
| 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 | <= nivel de DISPATCH_ |