função HidP_SetScaledUsageValue (hidpi.h)
A rotina de HidP_SetScaledUsageValue converte um número físico assinado e dimensionado em um o valor lógico do uso hid e define o valor de uso em um relatório HID especificado.
Sintaxe
NTSTATUS HidP_SetScaledUsageValue(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[in] LONG UsageValue,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in, out] PCHAR Report,
[in] ULONG ReportLength
);
Parâmetros
[in] ReportType
Especifica um valor de enumerador HIDP_REPORT_TYPE que indica o tipo de relatório HID localizado em Relatório.
[in] UsagePage
Especifica a página de uso de um uso.
[in] LinkCollection
Especifica a coleção de links que contém o uso. Se linkCollection não for zero, a rotina definirá apenas o uso, se houver, nesta coleção de links. Se LinkCollection for zero, a rotina definirá o primeiro uso encontrado na coleção de de nível superior associada a PreparsedData.
[in] Usage
Especifica o uso.
[in] UsageValue
Especifica o número físico assinado e dimensionado, que a rotina converte no valor lógico do uso.
[in] PreparsedData
Ponteiro para o dados pré-preparados de um nível superior.
[in, out] Report
Ponteiro para um relatório HID.
[in] ReportLength
Especifica o tamanho, em bytes, do relatório HID localizado em Report, que deve ser igual ao tamanho do relatório para o tipo de relatório especificado que HidP_GetCaps retorna na estrutura de HIDP_CAPS de uma coleção.
Valor de retorno
HidP_SetScaledUsageValue retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
| HIDP_STATUS_SUCCESS | A rotina definiu com êxito o valor de uso. |
| HIDP_STATUS_BAD_LOG_PHY_VALUES | O uso tem um intervalo lógico ou físico ilegal que impede o dimensionamento. |
| HIDP_STATUS_VALUE_OUT_OF_RANGE | O valor físico especificado está fora do intervalo e o uso não tem valor nulo. |
| HIDP_STATUS_INVALID_REPORT_LENGTH | O comprimento do relatório não é válido. |
| HIDP_STATUS_INVALID_REPORT_TYPE | O tipo de relatório especificado não é válido. |
| HIDP_STATUS_INCOMPATIBLE_REPORT_ID | O uso não existe no relatório especificado, mas ele existe em um relatório diferente do tipo especificado. |
| HIDP_STATUS_INVALID_PREPARSED_DATA | Os dados pré-parados não são válidos. |
| HIDP_STATUS_USAGE_NOT_FOUND | O uso não existe em nenhum relatório do tipo de relatório especificado. |
| HIDP_STATUS_NULL | O valor físico especificado está fora do intervalo, o uso tem um valor nulo e a rotina define o valor nulo. |
Observações
Valores dimensionados referem-se à saída ajustada de dados HID brutos, que são modificados com base em parâmetros específicos, como a confidencialidade e o intervalo do dispositivo. Esse ajuste permite uma interpretação mais significativa dos dados em relação ao uso pretendido do dispositivo.
Para entender melhor como os relatórios HID são interpretados e a importância dos valores dimensionados, consulte Interpretando relatórios HID.
HidP_SetScaledUsageValue define o bit de sinal.
Se a rotina retornar HIDP_STATUS_INCOMPATIBLE_REPORT_ID, o relatório especificado conterá o uso. No entanto, um driver de modo kernel ou aplicativo no modo de usuário pode definir o uso em um relatório inicializado zero. Consulte Inicializando relatórios HID.
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 | <= DISPATCH_LEVEL |