função HidP_SetUsages (hidpi.h)
Os conjuntos de rotina HidP_SetUsages especificaram botões de controle HID ON (1) em um relatório HID.
Sintaxe
NTSTATUS HidP_SetUsages(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in, out] PUSAGE UsageList,
[in, out] PULONG UsageLength,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in] PCHAR Report,
[in] ULONG ReportLength
);
Parâmetros
[in] ReportType
Especifica um valor de enumerador HIDP_REPORT_TYPE que indica o tipo de relatório localizado em Relatório.
[in] UsagePage
Especifica o da página de uso de para os usos especificados pelo UsageList.
[in] LinkCollection
Especifica a coleção de links que contém os usos. Se linkCollection não for zero, a rotina definirá apenas os usos, se existirem, nesta coleção de links. Se LinkCollection for zero, a rotina definirá o primeiro uso para cada uso especificado na coleção de de nível superior associada a PreparsedData.
[in, out] UsageList
Ponteiro para a matriz de usos.
[in, out] UsageLength
Especifica, na entrada, o número de usos em UsageList. Consulte a seção Comentários para obter informações sobre o valor de saída.
[in] PreparsedData
Ponteiro para o de dados pré-preparados da coleção de nível superior associada ao relatório localizado em Report.
[in] Report
Ponteiro para um relatório.
[in] ReportLength
Especifica o tamanho, em bytes, do relatório localizado em Relatório, que deve ser igual ao tamanho do relatório do tipo de relatório especificado que HidP_GetCaps retorna na estrutura de HIDP_CAPS de uma coleção.
Valor de retorno
HidP_SetUsages retorna um dos seguintes valores de status:
Código de retorno | Descrição |
---|---|
|
A rotina definiu com êxito o valor de uso. |
|
Não é possível definir um uso em uma matriz de botões porque a matriz já está totalmente definida. |
|
O comprimento do relatório não é válido. |
|
O tipo de relatório especificado não é válido. |
|
Um uso não existe no relatório especificado, mas ele existe em um relatório diferente do tipo especificado. |
|
Os dados pré-parados não são válidos. |
|
Um uso não existe em nenhum relatório do tipo de relatório especificado. |
Observações
Se HidP_SetUsages não puder definir um uso em UsageList, a rotina definirá UsageLength para o índice do uso que não pôde ser definido e retornará um valor de status que indica o erro.
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 |