Función GetRawInputDeviceInfoA (winuser.h)

Artículo
07/16/2024

Recupera información sobre el dispositivo de entrada sin procesar.

Sintaxis

UINT GetRawInputDeviceInfoA(
  [in, optional]      HANDLE hDevice,
  [in]                UINT   uiCommand,
  [in, out, optional] LPVOID pData,
  [in, out]           PUINT  pcbSize
);

Parámetros

[in, optional] hDevice

Tipo: HANDLE de

Identificador del dispositivo de entrada sin procesar. Esto procede del miembro de hDevice de RAWINPUTHEADER o de GetRawInputDeviceList.

[in] uiCommand

Tipo: UINT

Especifica qué datos se devolverán en pData. Este parámetro puede ser uno de los siguientes valores.

Valor	Significado
RIDI_PREPARSEDDATA 0x20000005	pData es un puntero de PHIDP_PREPARSED_DATA a un búfer para un de datos preparados de una colección de nivel superior.
RIDI_DEVICENAME 0x20000007	pData apunta a una cadena que contiene el nombre de la interfaz de dispositivo . Si este dispositivo se abierto con el modo de acceso compartido, puede llamar a CreateFile con este nombre para abrir una colección HID y usar el identificador devuelto para llamar a ReadFile para leer informes de entrada y WriteFile para enviar informes de salida. Para obtener más información, consulte apertura de colecciones HID y control de informes hid . Solo para este uiCommand, el valor de pcbSize es el recuento de caracteres (no el número de bytes).
RIDI_DEVICEINFO 0x2000000b	pData apunta a una estructura de RID_DEVICE_INFO.

Valor

Significado

RIDI_PREPARSEDDATA
0x20000005

pData es un puntero de PHIDP_PREPARSED_DATA a un búfer para un de datos preparados de una colección de nivel superior.

RIDI_DEVICENAME
0x20000007

pData apunta a una cadena que contiene el nombre de la interfaz de dispositivo .

Si este dispositivo se abierto con el modo de acceso compartido, puede llamar a CreateFile con este nombre para abrir una colección HID y usar el identificador devuelto para llamar a ReadFile para leer informes de entrada y WriteFile para enviar informes de salida.

Para obtener más información, consulte apertura de colecciones HID y control de informes hid .

Solo para este uiCommand, el valor de pcbSize es el recuento de caracteres (no el número de bytes).

RIDI_DEVICEINFO
0x2000000b

pData apunta a una estructura de RID_DEVICE_INFO.

[in, out, optional] pData

Tipo: LPVOID de

Puntero a un búfer que contiene la información especificada por uiCommand.

Si uiCommand es RIDI_DEVICEINFO, establezca el miembro cbSize de RID_DEVICE_INFO en sizeof(RID_DEVICE_INFO) antes de llamar a GetRawInputDeviceInfo.

[in, out] pcbSize

Tipo: PUINT

Tamaño, en bytes, de los datos de pData.

Valor devuelto

Tipo: UINT

Si se ejecuta correctamente, esta función devuelve un número no negativo que indica el número de bytes copiados en pData.

Si pData no es lo suficientemente grande para los datos, la función devuelve -1. Si pData es null, la función devuelve un valor de cero. En ambos casos, pcbSize se establece en el tamaño mínimo necesario para el búfer de pData de .

Llame a GetLastError para identificar cualquier otro error.

Observaciones

Nota

El encabezado winuser.h define GetRawInputDeviceInfo como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-rawinput-l1-1-0 (introducido en Windows 10, versión 10.0.14393)