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

Artigo
01/10/2024

O método IDirectInputJoyConfig8::SetTypeInfo cria um novo tipo de joystick ou redefine informações sobre um tipo de joystick existente.

Sintaxe

HRESULT SetTypeInfo(
  LPCWSTR          unnamedParam1,
  LPCDIJOYTYPEINFO unnamedParam2,
  DWORD            unnamedParam3,
  LPWSTR           unnamedParam4
);

Parâmetros

unnamedParam1

Aponta para o nome do tipo. O nome do tipo não pode exceder MAX_JOYSTRING caracteres, incluindo o caractere nulo de terminação. Se o nome do tipo ainda não existir, ele será criado. Não é possível alterar as informações de tipo para um tipo predefinido. O nome não pode começar com um caractere "#". Os tipos que começam com "#" são reservados pelo DirectInput.

unnamedParam2

Aponta para uma estrutura que recebe informações sobre o tipo de joystick.

unnamedParam3

Especifica as partes da estrutura DIJOYTYPEINFO apontadas por pjti que contêm valores a serem definidos.

DITC_REGHWSETTINGS

Indica que as configurações de hardware do Registro para o joystick são válidas.

DITC_CLSIDCONFIG

Indica que a configuração do joystick CLSID é válida. Se o valor for todos zeros, não haverá nenhuma configuração personalizada para esse tipo de joystick.

DITC_DISPLAYNAME

Indica que o nome de exibição para o tipo de joystick é válido.

DITC_CALLOUT

Indica que o texto explicativo para o tipo de joystick é válido.

unnamedParam4

Se o nome do tipo for um tipo OEM que não esteja no formato VID_xxxx&PID_yyyy, esse parâmetro retornará o nome no formato VID_xxxx&PID_yyyy atribuído pelo Dinput. Esse nome VID_xxxx&PID_yyyy deve ser usado no campo DIJOYCONFIG.wszType ao chamar SetConfig.

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_NOTACQUIRED	A configuração do joystick não foi adquirida. Você deve chamar IDirectInputJoyConfig8::Acquire antes de poder notificar aplicativos e drivers de alterações na configuração do joystick.
DIERR_INVALIDPARAM	Um ou mais parâmetros eram inválidos.
DIERR_READONLY	Tentativa de alterar um tipo predefinido.

Requisitos


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

Compartilhar via