Compartir a través de

función HidD_GetFeature (hidsdi.h)

  • Artículo

La rutina HidD_GetFeature devuelve un informe de características de un colección de nivel superior especificado.

Sintaxis

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parámetros

[in] HidDeviceObject

Identificador abierto a una colección de nivel superior.

[out] ReportBuffer

Puntero a un búfer de informe HID asignado por el autor de la llamada que usa para especificar un identificador de informe. HidD_GetFeature usa ReportBuffer para devolver el informe de características especificado.

Para obtener más información sobre este parámetro, consulte la sección comentarios de.

[in] ReportBufferLength

Tamaño del búfer del informe en bytes. El búfer del informe debe ser lo suficientemente grande como para contener el informe de características más un byte adicional que especifique un identificador de informe distinto de cero. Si no se usa el identificador de informe, el valor del identificador es cero.

Valor devuelto

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

Observaciones

El ReportBufferLength correcto se especifica mediante el FeatureReportByteLength miembro de la estructura HIDP_CAPS de una colección de nivel superior devuelta desde HidP_GetCaps llamada.

Antes de llamar a la rutina HidD_GetFeature, el autor de la llamada debe hacer lo siguiente:

  • Si el de colección de nivel superior de incluye identificadores de informe, el autor de la llamada debe establecer el primer byte del parámetro ReportBuffer en un identificador de informe distinto de cero.
  • Si el colección de nivel superior no incluye identificadores de informe, el autor de la llamada debe establecer el primer byte del parámetro ReportBuffer en cero.

El informe de características se devuelve en el parámetro ReportBuffer. Según el identificador del informe, el autor de la llamada analiza el informe llamando a una de las funciones siguientes:

Para obtener un ejemplo de cómo analizar un informe HID, consulte la aplicación de ejemplo HClient. Este ejemplo se encuentra en la Galería de código de MSDN.

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

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 hidsdi.h (include Hidsdi.h)
biblioteca de Hid.lib
DLL de Hid.dll

Consulte también