HidP_SetData

9/8/2008

Essa função define um conjunto especificado do controle botão e valor usos HID em um relatório HID.

Syntax

NTSTATUS HidP_SetData(
  HIDP_REPORT_TYPE ReportType,
  PHIDP_DATA DataList,
  OUT PULONG DataLength,
  PHIDP_PREPARSED_DATA PreparsedData,
  PCHAR Report,
  ULONG ReportLength
);

Parameters

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

• DataList
  [no] Ponteiro para uma matriz de Caller-allocated HIDP_DATA estruturas que especificar quais botões e uso valores para definir.

• DataLength
  [in, Out] Na entrada, o número de membros a DataList matriz. Na saída, a seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  Valor de entrada está inalterado.	ReportType, PreparsedData, Relatório, ou ReportLength não são válidos.
  Valor de entrada está inalterado.	Dados de controle são definidos com êxito.
  Índice das DataList membro que causou o erro.	Não é possível definir dados de controle.

• PreparsedData
  [no] Ponteiro para uma parte superior-preparsed do nível dados.

• 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 HID localizado em Relatório, que deve ser igual ao tamanho de relatório para o tipo relatório especificado que o HidP_GetCaps função 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	Definição bem-sucedida de dados controle especificados pelo DataList.
HIDP_STATUS_INVALID_PREPARSED_DATA	Preparsed dados especificados por PreparsedData não é válido.
HIDP_STATUS_INVALID_REPORT_LENGTH	Tamanho, em bytes, do relatório HID não é igual ao comprimento especificado da coleção HIDP_CAPS estrutura para o tipo relatório especificado.
HIDP_STATUS_INVALID_REPORT_TYPE	Coleção não contém um relatório do tipo especificado.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	ReportType não é válido.
HIDP_STATUS_BUFFER_TOO_SMALL	Botão em uma matriz não estiver configurado para Ativado (um) como campos de matriz já são usados para índice outro botões.
HIDP_STATUS_BUTTON_NOT_PRESSED	DataList parâmetro definiu um botão para desativado (zero), mas o botão já está definido para Desativado.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	Índice de dados de um membro DataList não é válido.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Valor do botão ou uso está contido em um relatório, mas não é no relatório especificado.
HIDP_STATUS_IS_VALUE_ARRAY	Índice de dados especifica uma matriz valor de uso.

Remarks

Exceto para uso valor matrizes, pode usar um cliente HID HidP_SetData Para definir botões e valores de uso em um relatório. Para definir uma matriz valor de uso, um aplicativo ou driver deve usar o HidP_SetUsageValueArray função.

Requirements

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

See Also

Reference

HIDP_DATA
HidP_GetData
HidP_SetButtons
HidP_SetUsages
HidP_SetUsageValueArray
HidP_UnsetButtons
HidP_UnsetUsages