HidD_GetPhysicalDescriptor función (hidsdi.h)
La rutina HidD_GetPhysicalDescriptor devuelve el Descriptor físico de una colección 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, un descriptor físico podría indicar que el pulgar derecho se usa para activar el botón 5.
Tenga en cuenta que los 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 los descriptores físicos ayudan a diferentes aplicaciones a asignar funcionalidad a estos controles de forma más coherente. Consulta 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 la rutina usa para devolver el descriptor físico solicitado.
[in] BufferLength
Especifica la longitud, en bytes, del búfer en buffer.
Valor devuelto
HidD_GetPhysicalDescriptor devuelve TRUE si se realiza correctamente; de lo contrario, devuelve FALSE. Use GetLastError para obtener información de error extendida.
Comentarios
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 | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Universal |
| Encabezado | hidsdi.h (include Hidsdi.h) |
| Library | Hid.lib |
| Archivo DLL | Hid.dll |