HidP_UsageListDifference función (hidpi.h)

La rutina HidP_UsageListDifference devuelve las diferencias entre dos matrices de usos de HID.

Sintaxis

NTSTATUS HidP_UsageListDifference(
  [in]  PUSAGE PreviousUsageList,
  [in]  PUSAGE CurrentUsageList,
  [out] PUSAGE BreakUsageList,
  [out] PUSAGE MakeUsageList,
  [in]  ULONG  UsageListLength
);

Parámetros

[in] PreviousUsageList

Puntero a una lista de usos que la rutina compara con la lista de usos de CurrentUsageList.

[in] CurrentUsageList

Puntero a una lista de usos que la rutina compara con la lista de usos de PreviousUsageList.

[out] BreakUsageList

Puntero a un búfer asignado por el autor de la llamada que, a cambio, contiene una lista de los usos que se encuentran en PreviousUsageList, pero no en CurrentUsageList.

[out] MakeUsageList

Puntero a un búfer asignado por el autor de la llamada que, a cambio, contiene una lista de los usos que se encuentran en CurrentUsageList, pero no en PreviousUsageList.

[in] UsageListLength

Especifica la longitud, en los elementos de matriz, de los búferes proporcionados en CurrentUsageList y PreviousUsageList.

Valor devuelto

HidP_UsageListDifference devuelve HIDP_STATUS_SUCCESS.

Comentarios

Una aplicación en modo de usuario o un controlador en modo kernel puede usar esta rutina para comparar dos listas de uso, por ejemplo, para determinar el cambio en el estado del botón entre dos listas de uso devueltas por dos llamadas de HidP_GetButtons .

Si las listas de uso de entrada tienen longitudes diferentes, una aplicación o controlador debe establecer UsageListLength en la longitud de la lista más grande.

La rutina interpreta un uso cero en una lista de uso de entrada como delimitador que finaliza la lista. No se procesan los usos después de un cero de una lista. Los usos sin usar de una lista de salida se establecen en cero.

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

Requisitos

Consulte también

HidP_UsageAndPageListDifference