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

Artículo
01/10/2024

El método IDirectInputJoyConfig8::SetTypeInfo crea un nuevo tipo de joystick o vuelve a definir información sobre un tipo de joystick existente.

Sintaxis

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

Parámetros

unnamedParam1

Apunta al nombre del tipo. El nombre del tipo no puede superar MAX_JOYSTRING caracteres, incluido el carácter nulo de terminación. Si el nombre de tipo aún no existe, se crea. No se puede cambiar la información de tipo de un tipo predefinido. El nombre no puede comenzar con un carácter "#". Los tipos que comienzan por "#" están reservados por DirectInput.

unnamedParam2

Apunta a una estructura que recibe información sobre el tipo de joystick.

unnamedParam3

Especifica las partes de la estructura DIJOYTYPEINFO a la que apunta pjti que contienen valores que se van a establecer.

DITC_REGHWSETTINGS

Indica que la configuración de hardware del Registro para el joystick es válida.

DITC_CLSIDCONFIG

Indica que el CLSID de configuración del joystick es válido. Si el valor es de ceros, no hay ninguna configuración personalizada para este tipo de joystick.

DITC_DISPLAYNAME

Indica que el nombre para mostrar del tipo de joystick es válido.

DITC_CALLOUT

Indica que la llamada para el tipo de joystick es válida.

unnamedParam4

Si el nombre del tipo es un tipo OEM que no está en VID_xxxx&PID_yyyy formato, este parámetro devolverá el nombre en VID_xxxx&PID_yyyy formato asignado por Dinput. Este nombre VID_xxxx&PID_yyyy debe usarse en el campo DIJOYCONFIG.wszType al llamar a SetConfig.

Valor devuelto

Devuelve DI_OK si se ejecuta correctamente; de lo contrario, devuelve uno de los siguientes valores de error COM:

Código devuelto	Descripción
DIERR_NOTACQUIRED	No se ha adquirido la configuración del joystick. Debe llamar a IDirectInputJoyConfig8::Acquire para poder notificar a las aplicaciones y controladores los cambios en la configuración del joystick.
DIERR_INVALIDPARAM	Uno o varios parámetros no eran válidos.
DIERR_READONLY	Se intentó cambiar un tipo predefinido.

Requisitos


Plataforma de destino	Escritorio
Encabezado	dinputd.h (incluya Dinputd.h)

Share via