Skip to main content

XInputGetCapabilities

Recupera las funcionalidades y características de un mando conectado.

Sintaxis

Parámetros

dwUserIndex   _In_
Tipo: DWORD
Índice del jugador asociado al dispositivo; un valor en el intervalo de 0 a XUSER_MAX_COUNT - 1. dwFlags   _In_
Tipo: DWORD
Marcas de entrada que identifican el tipo de mando. Si este valor es 0, se devuelven las funcionalidades de todos los mandos conectados al sistema. Actualmente, solo se admite XINPUT_FLAG_GAMEPAD. pCapabilities   _Out_
Tipo: XINPUT_CAPABILITIES*
Puntero a un objeto XINPUT_CAPABILITIES que recibe las funcionalidades del mando.

Valor devuelto

Tipo: DWORD Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS. Si el mando no está conectado, el valor devuelto es ERROR_DEVICE_NOT_CONNECTED. Si la función da error, el valor devuelto es un código de error definido en WinError.h. La función no usa SetLastError para establecer el último código de error del subproceso que realiza la llamada.

Comentarios

La versión heredada de XINPUT 9.1.0 (incluida en Windows Vista y versiones posteriores) siempre devolvía un conjunto fijo de funcionalidades, independientemente del dispositivo conectado.
Para obtener detalles sobre las funcionalidades notificadas, consulte XINPUT_CAPABILITIES. Para obtener más información, consulte El contenedor XInputOnGameInput.

Requisitos

Encabezado: XInputOnGameInput.h Biblioteca: xgameruntime.lib Plataformas compatibles: consolas de la familia XBOX One y consolas XBOX Series

Consulte también

Portabilidad de XInput a GameInput
XInputOnGameInput
Última modificación el 28 de agosto de 2026