funzione HidP_UsageListDifference (hidpi.h)
La routine HidP_UsageListDifference restituisce le differenze tra due matrici di utilizzi HID .
Sintassi
NTSTATUS HidP_UsageListDifference(
[in] PUSAGE PreviousUsageList,
[in] PUSAGE CurrentUsageList,
[out] PUSAGE BreakUsageList,
[out] PUSAGE MakeUsageList,
[in] ULONG UsageListLength
);
Parametri
[in] PreviousUsageList
Puntatore a un elenco di utilizzi confrontati dalla routine con l'elenco di utilizzi in CurrentUsageList.
[in] CurrentUsageList
Puntatore a un elenco di utilizzi confrontati dalla routine con l'elenco di utilizzi in PreviousUsageList.
[out] BreakUsageList
Puntatore a un buffer allocato dal chiamante che, in caso di restituzione, contiene un elenco degli utilizzi presenti in PreviousUsageList, ma non in CurrentUsageList.
[out] MakeUsageList
Puntatore a un buffer allocato dal chiamante che, in caso di restituzione, contiene un elenco degli utilizzi presenti in CurrentUsageList, ma non in PreviousUsageList.
[in] UsageListLength
Specifica la lunghezza, negli elementi della matrice, dei buffer forniti in CurrentUsageList e PreviousUsageList.
Valore restituito
HidP_UsageListDifference restituisce HIDP_STATUS_SUCCESS.
Osservazioni
Un'applicazione in modalità utente o un driver in modalità kernel può usare questa routine per confrontare due elenchi di utilizzo, ad esempio per determinare la modifica dello stato del pulsante tra due elenchi di utilizzo restituiti da due chiamate HidP_GetButtons.
Se gli elenchi di utilizzo di input hanno lunghezze diverse, un'applicazione o un driver deve impostare UsageListLength sulla lunghezza dell'elenco più grande.
La routine interpreta un utilizzo zero in un elenco di utilizzo di input come delimitatore che termina l'elenco. Eventuali utilizzi dopo zero in un elenco non vengono elaborati. Gli utilizzi inutilizzati in un elenco di output sono impostati su zero.
Per altre informazioni, vedere raccolte HID.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 2000 e versioni successive di Windows. |
| piattaforma di destinazione | Universale |
| intestazione | hidpi.h (include Hidpi.h) |
| libreria | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |