Share via

Función joySetCapture (joystickapi.h)

  • Artículo

La función joySetCapture captura un joystick haciendo que sus mensajes se envíen a la ventana especificada.

Sintaxis

MMRESULT joySetCapture(
  HWND hwnd,
  UINT uJoyID,
  UINT uPeriod,
  BOOL fChanged
);

Parámetros

hwnd

Maneje la ventana para recibir los mensajes del joystick.

uJoyID

Identificador del joystick que se va a capturar. Valores válidos para el intervalo uJoyID de cero (JOYSTICKID1) a 15.

uPeriod

Frecuencia de sondeo, en milisegundos.

fChanged

Cambie la marca de posición. Especifique TRUE para que este parámetro envíe mensajes solo cuando la posición cambie por un valor mayor que el umbral de movimiento del joystick. De lo contrario, los mensajes se envían con la frecuencia de sondeo especificada en uPeriod.

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.
MMSYSERR_INVALPARAM
 El id. de joystick o hwnd no válido es NULL.
JOYERR_NOCANDO
 No se puede capturar la entrada del joystick porque un servicio necesario (como un temporizador de Windows) no está disponible.
JOYERR_UNPLUGGED
 El joystick especificado no está conectado al sistema.
JOYERR_PARMS
 El id. de joystick o hwnd no válido es NULL.

Comentarios

Si el joystick especificado se captura actualmente, la función devuelve un comportamiento indefinido. Llame a la función joyReleaseCapture para liberar el joystick capturado o destruir la ventana para liberar el joystick automáticamente.

Requisitos

   
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