Compartilhar via

função HidD_GetFeature (hidsdi.h)

  • Artigo

A rotina de HidD_GetFeature retorna um relatório de recursos de uma coleção de de nível superior especificada.

Sintaxe

BOOLEAN HidD_GetFeature(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parâmetros

[in] HidDeviceObject

Um identificador aberto para uma coleção de nível superior.

[out] ReportBuffer

Ponteiro para um buffer de relatório HID alocado pelo chamador que o chamador usa para especificar uma ID de relatório. HidD_GetFeature usa do ReportBuffer para retornar o relatório de recursos especificado.

Para obter mais informações sobre esse parâmetro, consulte a seção comentários.

[in] ReportBufferLength

O tamanho do buffer de relatório em bytes. O buffer de relatório deve ser grande o suficiente para manter o relatório de recursos mais um byte adicional que especifica uma ID de relatório diferente de zero. Se a ID do relatório não for usada, o valor da ID será zero.

Valor de retorno

Se HidD_GetFeature for bem-sucedido, ele retornará verdadeiro; caso contrário, ele retornará FALSE . Use GetLastError para obter informações de erro estendidas.

Observações

O ReportBufferLength correto é especificado pelo FeatureReportByteLength da estrutura de HIDP_CAPS de uma coleção de nível superior retornada de HidP_GetCaps chamada.

Antes de chamar a rotina de HidD_GetFeature, o chamador deve fazer o seguinte:

  • Se o coleção de nível superior incluir IDs de relatório, o chamador deverá definir o primeiro byte do parâmetro ReportBuffer como uma ID de relatório diferente de zero.
  • Se o coleção de nível superior não incluir IDs de relatório, o chamador deverá definir o primeiro byte do parâmetro ReportBuffer como zero.

O relatório de recursos é retornado no parâmetro ReportBuffer. Dependendo da ID do relatório, o chamador analisa o relatório chamando uma das seguintes funções:

Para obter um exemplo de como analisar um relatório HID, consulte o aplicativo de exemplo do HClient. Este exemplo está localizado na Galeria de Códigos do MSDN.

Somente aplicativos no modo de usuário podem chamar HidD_GetFeature. Os drivers no modo kernel podem usar uma solicitação IOCTL_HID_GET_FEATURE.

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 hidsdi.h (inclua Hidsdi.h)
biblioteca Hid.lib
de DLL Hid.dll

Consulte também