Função joyGetDevCapsA (joystickapi.h)

Artigo
11/20/2024

A função joyGetDevCaps consulta um joystick para determinar suas funcionalidades.

Sintaxe

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA 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 de 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 de JOYCAPS.

Valor de retorno

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

Código de retorno	Descrição
MMSYSERR_NODRIVER	O driver do 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.

Observações

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.

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	joystickapi.h (inclua Windows.h)
biblioteca	Winmm.lib
de DLL	Winmm.dll

Consulte também

joysticks
do Joystick Multimídia

Compartilhar via