HidP_UnsetUsages

9/8/2008

Essa função define especificados usos botão controle HID desativado (zero) em um relatório HID.

Syntax

NTSTATUS HidP_UnsetUsages(
  HIDP_REPORT_TYPE ReportType,
  USAGE UsagePage,
  USHORT LinkCollection,
  PUSAGE UsageList,
  PULONG UsageLength,
  PHIDP_PREPARSED_DATA PreparsedData,
  PCHAR Report,
  ULONG ReportLength
);

Parameters

• ReportType
  [no] HIDP_REPORT_TYPE enumerador valor que indica o tipo de relatório localizado em Relatório.

• UsagePage
  [no] Página de uso dos usos especificados por UsageList.

• LinkCollection
  [no] Opcional. Link coleção que contém os usos. Se LinkCollection é diferente de zero, a função apenas define os usos, se existirem, na coleção link. Se LinkCollection for zero, a função define o primeiro uso para cada uso-localiza na de alto nível coleção associado com PreparsedData.

• UsageList
  [no] Ponteiro para a matriz de usos para definir como Desativado.

• UsageLength
  [in, Out] Na entrada, o número de usos em UsageList.

  A seguinte tabela mostra os valores possíveis na saída.

  Valor	Descrição
  Valor de entrada está inalterado.	ReportType, PreparsedData, Relatório, ou ReportLength não é válido.
  Valor de entrada está inalterado.	Todos os usos com êxito estiverem definidos como desativada.
  O índice do uso em UsageList que causou o erro.	Um uso não pode ser definido como desativada.

• PreparsedData
  [no] Ponteiro para os dados preparsed do de alto nível coleção associado com o relatório localizado em Relatório.

• Relatório
  [in, Out] Na entrada, um relatório HID inicializada. Na saída, um ponteiro para um relatório HID.

• ReportLength
  [no] Tamanho, em bytes, do relatório localizado em Relatório, que deve ser igual ao tamanho de relatório para o tipo especificado relatório que HidP_GetCaps Retorna do uma coleção HIDP_CAPS estrutura.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
HIDP_STATUS_SUCCESS	Todos os usos em UsageList Com êxito estiver definida como desativada.
HIDP_STATUS_INVALID_PREPARSED_DATA	Preparsed dados especificados por PreparsedData não é válido.
HIDP_STATUS_INVALID_REPORT_LENGTH	Comprimento de relatório não é válido.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipo de relatório não é válido.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Coleção não contém um relatório do tipo especificado.
HIDP_STATUS_BUTTON_NOT_PRESSED	Uso já está definido como desativada.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Relatório contém uma coleção com os botões na página a uso especificado, mas há não tais usos no relatório.
HIDP_STATUS_USAGE_NOT_FOUND	Relatório contém um uso solicitado que não esteja em qualquer relatório com suporte pela de alto nível coleção.

Remarks

Os termos botão e o uso são usados como sinônimo.

Requirements

Header	hidpi.h
Library	Hidparse_lib.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HIDP_CAPS
HidP_GetCaps
HIDP_REPORT_TYPE
HidP_SetButtons
HidP_SetData
HidP_SetUsages
HidP_UnsetButtons