función HidP_UnsetUsages (hidpi.h)

Artículo
02/07/2025

La rutina HidP_UnsetUsages establece el botón de control HID especificado usos OFF (cero) en un informe HID.

Sintaxis

NTSTATUS HidP_UnsetUsages(
  [in]           HIDP_REPORT_TYPE     ReportType,
  [in]           USAGE                UsagePage,
  [in, optional] USHORT               LinkCollection,
  [in, out]      PUSAGE               UsageList,
  [in, out]      PULONG               UsageLength,
  [in]           PHIDP_PREPARSED_DATA PreparsedData,
  [in]           PCHAR                Report,
  [in]           ULONG                ReportLength
);

Parámetros

[in] ReportType

Especifica un valor de enumerador HIDP_REPORT_TYPE que indica el tipo de informe ubicado en Informe.

[in] UsagePage

Especifica la página de uso de los usos especificados por UsageList.

[in, optional] LinkCollection

Especifica el de colección de vínculos de que contiene los usos. Si linkCollection es distinto de cero, la rutina solo establece los usos, si existen, en esta colección de vínculos. Si LinkCollection es cero, la rutina establece el primer uso para cada uso que encuentra en la colección de nivel superior asociada a PreparsedData.

[in, out] UsageList

Puntero a la matriz de usos que se va a establecer en OFF.

[in, out] UsageLength

Especifica, en la entrada, el número de usos de UsageList. Consulte la sección Comentarios para obtener información sobre el valor de salida.

[in] PreparsedData

Puntero al de datos preparados de la colección de nivel superior asociada al informe ubicado en Informe.

[in] Report

Puntero a un informe.

[in] ReportLength

Especifica el tamaño, en bytes, del informe ubicado en Informe, que debe ser igual a la longitud del informe para el tipo de informe especificado que HidP_GetCaps devuelve en la estructura HIDP_CAPS de una colección.

Valor devuelto

HidP_UnsetUsages devuelve HIDP_STATUS_SUCCESS si se establece correctamente en OFF todos los usos de UsageList.

HidP_UnsetUsages devuelve uno de los siguientes valores de estado si uno de los parámetros de entrada no es válido:

Código devuelto	Descripción
HIDP_STATUS_INVALID_PREPARSED_DATA	Los datos preparados especificados por preparsedData no son válidos.
HIDP_STATUS_INVALID_REPORT_LENGTH	La longitud del informe no es válida.
HIDP_STATUS_INVALID_REPORT_TYPE	El tipo de informe no es válido.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	La colección no contiene un informe del tipo especificado.

HidP_UnsetUsages devuelve uno de los siguientes valores de estado si no se pudo establecer en OFF uno de los usos de UsageList:

Código devuelto	Descripción
HIDP_STATUS_BUTTON_NOT_PRESSED	Un uso ya está establecido en OFF.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Un uso no está incluido en el informe especificado, pero se encuentra en otro informe del tipo especificado.
HIDP_STATUS_USAGE_NOT_FOUND	La rutina no encontró un uso en ningún informe del tipo especificado.

Observaciones

HidP_UnsetUsages establece UsageLength de la siguiente manera:

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	<=DISPATCH_LEVEL

Consulte también

Compartir a través de