función HidP_UnsetUsages (hidpi.h)

La rutina HidP_UnsetUsages establece los usos de botón de control HID especificados 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 la colección de vínculos que contiene los usos. Si LinkCollection no es 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 en UsageList. Consulte la sección Comentarios para obtener información sobre el valor de salida.

[in] PreparsedData

Puntero a los 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:

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

Comentarios

HidP_UnsetUsages establece UsageLength de la siguiente manera:

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

Requisitos

Consulte también

HidP_SetButtons

HidP_SetData

HidP_SetUsages

HidP_UnsetButtons

_HIDP_PREPARSED_DATA