Compartilhar via


Função joyGetDevCaps (joystickapi.h)

A função joyGetDevCaps consulta um joystick para determinar seus recursos.

Sintaxe

MMRESULT joyGetDevCaps(
  UINT      uJoyID,
  LPJOYCAPS pjc,
  UINT      cbjc
);

Parâmetros

uJoyID

Identificador do joystick a ser consultado. Os valores válidos para uJoyID variam de -1 a 15. Um valor de -1 permite a recuperação do membro szRegKey da estrutura JOYCAPS , quer um dispositivo esteja presente ou não.

pjc

Ponteiro para uma estrutura JOYCAPS para conter os recursos do joystick.

cbjc

Tamanho, em bytes, da estrutura JOYCAPS .

Valor retornado

Retorna JOYERR_NOERROR se tiver êxito ou um dos seguintes valores de erro:

Código de retorno Descrição
MMSYSERR_NODRIVER
O driver de joystick não está presente ou o identificador de joystick especificado é inválido. O identificador de joystick especificado é inválido.
MMSYSERR_INVALPARAM
Um parâmetro inválido foi passado.

Comentários

Use a função joyGetNumDevs para determinar o número de dispositivos joystick compatíveis com o driver.

Esse método falha quando passado um valor inválido para o parâmetro cbjc .

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