Compartilhar via

função HidD_SetFeature (hidsdi.h)

  • Artigo

A rotina HidD_SetFeature envia um relatório de recurso para uma coleção de nível superior.

Sintaxe

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

Parâmetros

[in] HidDeviceObject

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

[in] ReportBuffer

Ponteiro para um buffer de relatório de recurso alocado pelo chamador que o chamador usa para especificar uma ID de relatório HID.

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.

Retornar valor

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

Comentários

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

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

Para obter um exemplo de como preparar e um relatório HID e enviá-lo para uma coleção de nível superior, consulte o aplicativo de exemplo HClient .

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho hidsdi.h (inclua Hidsdi.h)
Biblioteca Hid.lib
DLL Hid.dll

Confira também