Compartilhar via

Função joySetCapture (joystickapi.h)

  • Artigo

A função joySetCapture captura um joystick fazendo com que suas mensagens sejam enviadas para a janela especificada.

Sintaxe

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

Parâmetros

hwnd

Manipule para a janela para receber as mensagens do joystick.

uJoyID

Identificador do joystick a ser capturado. Os valores válidos para uJoyID variam de zero (JOYSTICKID1) a 15.

uPeriod

Frequência de sondagem, em milissegundos.

fChanged

Alterar sinalizador de posição. Especifique TRUE para que esse parâmetro envie mensagens somente quando a posição for alterada por um valor maior que o limite de movimento do joystick. Caso contrário, as mensagens são enviadas na frequência de sondagem especificada em uPeriod.

Valor retornado

Retorna JOYERR_NOERROR se tiver êxito ou um dos valores de erro a seguir.

Código de retorno Descrição
MMSYSERR_NODRIVER
 O joystick driver não está presente.
MMSYSERR_INVALPARAM
 A ID de joystick ou hwnd inválida é NULL.
JOYERR_NOCANDO
 Não é possível capturar a entrada do joystick porque um serviço necessário (como um temporizador do Windows) não está disponível.
JOYERR_UNPLUGGED
 O joystick especificado não está conectado ao sistema.
JOYERR_PARMS
 A ID de joystick ou hwnd inválida é NULL.

Comentários

Se o joystick especificado for capturado no momento, a função retornará um comportamento indefinido. Chame a função joyReleaseCapture para liberar o joystick capturado ou destruir a janela para liberar o joystick automaticamente.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho joystickapi.h (inclua Windows.h)
Biblioteca Winmm.lib
DLL Winmm.dll

Confira também

Joysticks

Funções joystick multimídia