Compartilhar via


função HidP_UsageListDifference (hidpi.h)

A rotina HidP_UsageListDifference retorna as diferenças entre duas matrizes de usos de 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 por 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 por 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.

Valor de retorno

HidP_UsageListDifference retorna HIDP_STATUS_SUCCESS.

Observações

Um driver de modo de usuário ou 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 ao 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 um 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
de cliente com suporte mínimo Disponível no Windows 2000 e versões posteriores do Windows.
da Plataforma de Destino Universal
cabeçalho hidpi.h (inclua Hidpi.h)
biblioteca Hidparse.lib
IRQL PASSIVE_LEVEL

Consulte também

HidP_UsageAndPageListDifference