função HidD_GetPhysicalDescriptor (hidsdi.h)

Artigo
02/26/2024

A rotina HidD_GetPhysicalDescriptor retorna o Descritor Físico de uma coleção de nível superior que identifica o dispositivo físico da coleção.

O Descritor Físico é usado para indicar qual parte física do corpo humano é usada para ativar os controles em um dispositivo. Por exemplo, um Descritor Físico pode indicar que o polegar direito é usado para ativar o botão 5.

Observe que os Descritores Físicos são totalmente opcionais. Eles adicionam complexidade e oferecem muito pouco em troca da maioria dos dispositivos. No entanto, alguns dispositivos, particularmente aqueles com um grande número de controles idênticos (por exemplo, botões) descobrirão que os Descritores Físicos ajudam diferentes aplicativos a atribuir funcionalidade a esses controles de maneira mais consistente. Confira Especificação hid para obter mais informações.

Sintaxe

BOOLEAN HidD_GetPhysicalDescriptor(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  Buffer,
  [in]  ULONG  BufferLength
);

Parâmetros

[in] HidDeviceObject

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

[out] Buffer

Ponteiro para um buffer alocado pelo chamador que a rotina usa para retornar o descritor físico solicitado.

[in] BufferLength

Especifica o comprimento, em bytes, do buffer em Buffer.

Retornar valor

HidD_GetPhysicalDescriptorretornará TRUE se tiver êxito; caso contrário, retornará FALSE. Use GetLastError para obter informações de erro estendidas.

Comentários

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

Para obter mais informações, consulte Coleções HID.

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