função HidP_UsageListDifference (hidpi.h)

  • Artigo

A rotina HidP_UsageListDifference retorna as diferenças entre duas matrizes de usos hid.

Sintaxe

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

Parâmetros

[in] PreviousUsageList

Ponteiro para uma lista de usos que a rotina compara com a lista de usos em CurrentUsageList.

[in] CurrentUsageList

Ponteiro para uma lista de usos que a rotina compara com a lista de usos em PreviousUsageList.

[out] BreakUsageList

Ponteiro para um buffer alocado pelo chamador que, no retorno, contém uma lista dos usos que estão em PreviousUsageList, mas não em CurrentUsageList.

[out] MakeUsageList

Ponteiro para um buffer alocado pelo chamador que, no retorno, contém uma lista dos usos que estão em CurrentUsageList, mas não em PreviousUsageList.

[in] UsageListLength

Especifica o comprimento, em elementos de matriz, dos buffers fornecidos em CurrentUsageList e PreviousUsageList.

Retornar valor

HidP_UsageListDifference retorna HIDP_STATUS_SUCCESS.

Comentários

Um aplicativo no modo de usuário ou driver de modo kernel pode usar essa rotina para comparar duas listas de uso, por exemplo, para determinar a alteração no estado do botão entre duas listas de uso retornadas por duas chamadas HidP_GetButtons .

Se as listas de uso de entrada tiverem comprimentos diferentes, um aplicativo ou driver deverá definir UsageListLength para o comprimento da lista maior.

A rotina interpreta um uso zero em uma lista de uso de entrada como um delimitador que encerra a lista. Os usos após zero em uma lista não são processados. Os usos não utilizados em uma lista de saída são definidos como zero.

Para obter mais informações, consulte Coleções HID.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho hidpi.h (inclua Hidpi.h)
Biblioteca Hidparse.lib
IRQL PASSIVE_LEVEL

Confira também

HidP_UsageAndPageListDifference