función HidP_GetExtendedAttributes (hidpi.h)

  • Artículo

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 los datos preparados para la 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 la rutina usa para devolver los atributos extendidos del control especificado por DataIndex.

[in, out] LengthAttributes

Especifica el tamaño, en bytes, del búfer Atributos (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
HIDP_STATUS_SUCCESS
 La rutina devolvió correctamente toda la información de atributo extendido del control.
HIDP_STATUS_BUFFER_TOO_SMALL
 El búfer atributo no era lo suficientemente grande como para contener toda la información de atributo extendida.
HIDP_STATUS_DATA_INDEX_NOT_FOUND
 El índice de datos especificado no es válido.

Comentarios

HidP_GetExtendedAttributes devuelve una estructura de longitud variable HIDP_EXTENDED_ATTRIBUTES en el búfer Atributo . La estructura de atributos extendidos contiene, en orden consecutivo, los miembros de longitud fija (NumGlobalUnknowns, Reserved y GlobalUnknowns) seguidos de una matriz de longitud variable de estructuras HIDP_UNKNOWN_TOKEN . El primer miembro de la matriz de tokens desconocida se encuentra en (PHIDP_UNKNOWN_TOKEN*)&(Attributes-Data>).

La rutina devuelve tantos bytes de la información de atributo extendida como el búfer atributo 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 llamador puede usar primero el búfer Atributos para devolver el valor del miembro NumGlobalUnknowns de la información de atributos extendidos.

Para obtener más información, consulte Colecciones HID.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado hidpi.h (incluya Hidpi.h)
Library Hidparse.lib
IRQL <= DISPATCH_ LEVEL

Consulte también

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA