función HidD_SetFeature (hidsdi.h)

  • Artículo

La rutina HidD_SetFeature envía un informe de características a una colección de nivel superior.

Sintaxis

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

Parámetros

[in] HidDeviceObject

Identificador abierto a una colección de nivel superior.

[in] ReportBuffer

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

Para obtener más información sobre este parámetro, vea la sección Comentarios .

[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 de id. es cero.

Valor devuelto

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

Comentarios

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

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

Para obtener un ejemplo de cómo preparar y enviar un informe HID a una colección de nivel superior, consulte la aplicación de ejemplo HClient .

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

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 2000 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado hidsdi.h (include Hidsdi.h)
Library Hid.lib
Archivo DLL Hid.dll

Consulte también