función HidD_GetPreparsedData (hidsdi.h)

La rutina HidD_GetPreparsedData devuelve los datos preparadosde una colección de nivel superior.

Sintaxis

BOOLEAN HidD_GetPreparsedData(
  [in]  HANDLE               HidDeviceObject,
  [out] PHIDP_PREPARSED_DATA *PreparsedData
);

Parámetros

[in] HidDeviceObject

Especifica un identificador abierto para una colección de nivel superior.

[out] PreparsedData

Puntero a la dirección de un búfer asignado de rutina que contiene los datos preparados de una colección en una estructura _HIDP_PREPARSED_DATA .

Valor devuelto

HidD_GetPreparsedData devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE. Use GetLastError para obtener información de error extendida.

Comentarios

Solo las aplicaciones en modo de usuario pueden llamar a HidD_GetPreparsedData. Los controladores en modo kernel pueden usar una solicitud de IOCTL_HID_GET_COLLECTION_DESCRIPTOR .

Cuando una aplicación ya no requiere los datos preparados, debe llamar a HidD_FreePreparsedData para liberar el búfer de datos preparados.

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

Requisitos

Consulte también

HidD_FreePreparsedData

IOCTL_HID_GET_COLLECTION_DESCRIPTOR

_HIDP_PREPARSED_DATA