fonction HidP_UsageListDifference (hidpi.h)

  • Article

La routine HidP_UsageListDifference retourne les différences entre deux tableaux d’utilisation hid.

Syntaxe

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

Paramètres

[in] PreviousUsageList

Pointeur vers une liste d’utilisations que la routine compare à la liste des utilisations dans CurrentUsageList.

[in] CurrentUsageList

Pointeur vers une liste d’utilisations que la routine compare à la liste des utilisations dans PreviousUsageList.

[out] BreakUsageList

Pointeur vers une mémoire tampon allouée à l’appelant qui, au retour, contient une liste des utilisations qui se trouvent dans PreviousUsageList, mais pas dans CurrentUsageList.

[out] MakeUsageList

Pointeur vers une mémoire tampon allouée à l’appelant qui, en retour, contient une liste des utilisations qui se trouvent dans CurrentUsageList, mais pas dans PreviousUsageList.

[in] UsageListLength

Spécifie la longueur, dans les éléments de tableau, des mémoires tampons fournies dans CurrentUsageList et PreviousUsageList.

Valeur retournée

HidP_UsageListDifference retourne HIDP_STATUS_SUCCESS.

Remarques

Une application en mode utilisateur ou un pilote en mode noyau peut utiliser cette routine pour comparer deux listes d’utilisation, par exemple, afin de déterminer le changement d’état du bouton entre deux listes d’utilisation retournées par deux appels HidP_GetButtons .

Si les listes d’utilisation d’entrée ont des longueurs différentes, une application ou un pilote doit définir UsageListLength sur la longueur de la liste plus grande.

La routine interprète une utilisation nulle dans une liste d’utilisation d’entrée comme un délimiteur qui met fin à la liste. Les utilisations après un zéro dans une liste ne sont pas traitées. Les utilisations inutilisées dans une liste de sortie sont définies sur zéro.

Pour plus d’informations, consultez Collections HID.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows 2000 et versions ultérieures de Windows.
Plateforme cible Universal
En-tête hidpi.h (inclure Hidpi.h)
Bibliothèque Hidparse.lib
IRQL PASSIVE_LEVEL

Voir aussi

HidP_UsageAndPageListDifference