Función joyGetDevCapsW (joystickapi.h)

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

Sintaxis

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW pjc,
  UINT       cbjc
);

Parámetros

uJoyID

Identificador del joystick que se va a consultar. Los valores válidos para uJoyID van de -1 a 15. Un valor de -1 permite la recuperación del miembro szRegKey del JOYCAPS si un dispositivo está presente o no.

pjc

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

cbjc

Tamaño, en bytes, de la estructura de 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.

Observaciones

Use la función joyGetNumDevs para determinar el número de dispositivos joystick compatibles con 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 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 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	joystickapi.h (incluya Windows.h)
biblioteca de	Winmm.lib
DLL de	Winmm.dll

Consulte también

Joysticks

funciones de joystick multimedia