Función GetRawInputDeviceInfoW (winuser.h)

Artículo
08/27/2023

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

Sintaxis

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

Parámetros

[in, optional] hDevice

Tipo: HANDLE

Identificador del dispositivo de entrada sin procesar. Esto procede del miembro 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 valores siguientes.

Valor	Significado
RIDI_PREPARSEDDATA 0x20000005	pData es un puntero PHIDP_PREPARSED_DATA a un búfer para los datos preparados de una colección de nivel superior.
RIDI_DEVICENAME 0x20000007	pData apunta a una cadena que contiene el nombre de la interfaz del dispositivo. Si este dispositivo se abre 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 recuento de bytes).
RIDI_DEVICEINFO 0x2000000b	pData apunta a una estructura de RID_DEVICE_INFO .

Valor

Significado

RIDI_PREPARSEDDATA
0x20000005

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

RIDI_DEVICENAME
0x20000007

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

Si este dispositivo se abre 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 recuento de bytes).

RIDI_DEVICEINFO
0x2000000b

pData apunta a una estructura de RID_DEVICE_INFO .

[in, out, optional] pData

Tipo: LPVOID

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

Si uiCommand está 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 pData .

Llame a GetLastError para identificar cualquier otro error.

Comentarios

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 Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-rawinput-l1-1-0 (introducido en Windows 10, versión 10.0.14393)