Método IDirectInputJoyConfig8::GetConfig (dinputd.h)

Artigo
02/29/2024

O método IDirectInputJoyConfig8::GetConfig obtém informações sobre a configuração de um joystick.

Sintaxe

HRESULT GetConfig(
  UINT          unnamedParam1,
  LPDIJOYCONFIG unnamedParam2,
  DWORD         unnamedParam3
);

Parâmetros

unnamedParam1

Indica um número de identificação de joystick. É um inteiro não negativo. Para enumerar joysticks, comece com joystick zero e incremente o número do joystick em um até que a função retorne DIERR_NOMOREITEMS.

unnamedParam2

Aponta para uma estrutura que recebe informações sobre a configuração do joystick. O chamador "deve" inicializar o membro dwSize da estrutura DIJOYCONFIG antes de chamar esse método.

unnamedParam3

Especifica os membros da estrutura apontada pelo pjc que devem ser preenchidos. Esse parâmetro pode ser zero, um ou mais dos seguintes:

DIJC_GUIDINSTANCE

Indica que o GUID da instância do joystick está sendo solicitado. Um aplicativo pode passar o GUID da instância para IDirectInput::CreateDevice para obter uma interface IDirectInputDevice para o joystick. Observe que esse sinalizador não é um parâmetro válido para IDirectInputJoyConfig8::SetConfig.

DIJC_REGHWCONFIGTYPE

Indica que a configuração de hardware para o joystick (o membro hwc da estrutura DIJOYCONFIG) e o nome do tipo joystick (o membro wszType da mesma estrutura) estão sendo solicitados. Observe que a configuração de hardware e o nome do tipo não podem ser recuperados separadamente.

DIJC_GAIN

Indica que o ganho de force-feedback para o joystick está sendo solicitado.

DIJC_CALLOUT

Indica que o texto explicativo de sondagem do joystick está sendo solicitado.

Retornar valor

Retorna DI_OK se tiver êxito; caso contrário, retornará um dos seguintes valores de erro COM:

Código de retorno	Descrição
DIERR_INVALIDPARAM	Um ou mais parâmetros eram inválidos.
S_FALSE	O joystick especificado ainda não foi configurado.
DIERR_NOMOREITEMS	Não há mais joysticks disponíveis.

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	dinputd.h (include Dinputd.h)