funzione HidP_UsageListDifference (hidpi.h)

La routine HidP_UsageListDifference restituisce le differenze tra due matrici di utilizzo 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 che la routine confronta con l'elenco di utilizzi in CurrentUsageList.

[in] CurrentUsageList

Puntatore a un elenco di usi che la routine confronta 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 usi 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 usi 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.

Commenti

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. Qualsiasi utilizzo dopo zero in un elenco non viene elaborato. Gli usi inutilizzati in un elenco di output sono impostati su zero.

Per altre informazioni, vedere Raccolte HID.

Requisiti

Vedi anche

HidP_UsageAndPageListDifference