Función joyGetDevCapsA (joystickapi.h)

La función joyGetDevCaps consulta un joystick para determinar sus capacidades.

Sintaxis

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

Parámetros

uJoyID

Identificador del joystick que se va a consultar. Valores válidos para uJoyID intervalo de -1 a 15. Un valor de -1 permite recuperar el miembro szRegKey de la estructura JOYCAPS si un dispositivo está presente o no.

pjc

Puntero a una estructura JOYCAPS para contener las funciones del joystick.

cbjc

Tamaño, en bytes, de la estructura JOYCAPS .

Valor devuelto

Devuelve JOYERR_NOERROR si se ejecuta correctamente o uno de los siguientes valores de error:

Código devuelto	Descripción
MMSYSERR_NODRIVER	El controlador del joystick no está presente o el identificador del joystick especificado no es válido. El identificador de joystick especificado no es válido.
MMSYSERR_INVALPARAM	Se pasó un parámetro no válido.

Comentarios

Use la función joyGetNumDevs para determinar el número de dispositivos joystick admitidos por el controlador.

Este método produce un error cuando se pasa un valor no válido para el parámetro cbjc .

Nota

El encabezado joystickapi.h define joyGetDevCaps 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	joystickapi.h (incluye Windows.h)
Library	Winmm.lib
Archivo DLL	Winmm.dll

Consulte también

Joysticks
Funciones de joystick multimedia