fonction HidP_UsageListDifference (hidpi.h)
La routine HidP_UsageListDifference retourne les différences entre deux tableaux d’utilisations 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 par l’appelant qui, lors du 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 par l’appelant qui, lors du 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 à CurrentUsageList et PreviousUsageList.
Valeur de retour
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, pour déterminer la modification de l’é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 la longueur de la liste la plus grande.
La routine interprète une utilisation nulle dans une liste d’utilisation d’entrée en tant que délimiteur qui met fin à la liste. Toutes 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Universel |
| d’en-tête | hidpi.h (include Hidpi.h) |
| bibliothèque | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |