Share via

Função joyGetDevCapsW (joystickapi.h)

  • Artigo

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

Sintaxe

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW 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 .

Observação

O cabeçalho joystickapi.h define joyGetDevCaps como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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