função HidD_GetPhysicalDescriptor (hidsdi.h)
A rotina de HidD_GetPhysicalDescriptor retorna o Descriptor Físico de uma coleção de de nível superior que identifica o dispositivo físico da coleçã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 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 Descritores Físicos ajudar diferentes aplicativos a atribuir funcionalidade a esses controles de maneira mais consistente. Consulte de 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.
Valor de retorno
HidD_GetPhysicalDescriptor retorna verdadeiro se tiver êxito; caso contrário, ele retornará FALSE . Use GetLastError para obter informações de erro estendidas.
Observações
Somente aplicativos no modo de usuário podem chamar HidD_GetPhysicalDescriptor. Os drivers no modo kernel podem usar uma solicitação IOCTL_GET_PHYSICAL_DESCRIPTOR.
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 | hidsdi.h (inclua Hidsdi.h) |
| biblioteca | Hid.lib |
| de DLL | Hid.dll |