función HidD_GetPhysicalDescriptor (hidsdi.h)
La rutina HidD_GetPhysicalDescriptor devuelve el descriptor físico de de una colección de de nivel superior que identifica el dispositivo físico de la colección.
descriptor físico se usa para indicar qué parte física del cuerpo humano se usa para activar los controles en un dispositivo. Por ejemplo, una descriptor físico podría indicar que el pulgar derecho se usa para activar el botón 5.
Tenga en cuenta que descriptores físicos son totalmente opcionales. Agregan complejidad y ofrecen muy poco a cambio para la mayoría de los dispositivos. Sin embargo, algunos dispositivos, especialmente aquellos con un gran número de controles idénticos (por ejemplo, botones) encontrarán que descriptores físicos ayudar a diferentes aplicaciones a asignar funcionalidad a estos controles de forma más coherente. Consulta de especificación HID para obtener más información.
Sintaxis
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
Parámetros
[in] HidDeviceObject
Especifica un identificador abierto para una colección de nivel superior.
[out] Buffer
Puntero a un búfer asignado por el autor de la llamada que usa la rutina para devolver el descriptor físico solicitado.
[in] BufferLength
Especifica la longitud, en bytes, del búfer en Búfer.
Valor devuelto
HidD_GetPhysicalDescriptor devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE. Use GetLastError para obtener información de error extendida.
Observaciones
Solo las aplicaciones en modo de usuario pueden llamar a HidD_GetPhysicalDescriptor. Los controladores en modo kernel pueden usar una solicitud de IOCTL_GET_PHYSICAL_DESCRIPTOR.
Para obtener más información, consulte colecciones HID.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | hidsdi.h (include Hidsdi.h) |
| biblioteca de | Hid.lib |
| DLL de | Hid.dll |