Metodo IDirectInputJoyConfig8::SetTypeInfo (dinputd.h)

Articolo
01/10/2024

Il metodo IDirectInputJoyConfig8::SetTypeInfo crea un nuovo tipo di joystick o ridefine le informazioni su un tipo di joystick esistente.

Sintassi

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

Parametri

unnamedParam1

Punta al nome del tipo. Il nome del tipo non può superare MAX_JOYSTRING caratteri, incluso il carattere null terminante. Se il nome del tipo non esiste già, viene creato. Non è possibile modificare le informazioni sul tipo per un tipo predefinito. Il nome non può iniziare con un carattere "#". I tipi che iniziano con "#" sono riservati da DirectInput.

unnamedParam2

Punta a una struttura che riceve informazioni sul tipo di joystick.

unnamedParam3

Specifica le parti della struttura DIJOYTYPEINFO a cui fa riferimento pjti che contengono valori da impostare.

DITC_REGHWSETTINGS

Indica che le impostazioni hardware del Registro di sistema per il joystick sono valide.

DITC_CLSIDCONFIG

Indica che la configurazione del joystick CLSID è valida. Se il valore è tutti zero, non esiste alcuna configurazione personalizzata per questo tipo di joystick.

DITC_DISPLAYNAME

Indica che il nome visualizzato per il tipo di joystick è valido.

DITC_CALLOUT

Indica che il callout per il tipo di joystick è valido.

unnamedParam4

Se il nome del tipo è un tipo OEM non in formato VID_xxxx&PID_yyyy, questo parametro restituirà il nome nel formato VID_xxxx&PID_yyyy assegnato da Dinput. Questo nome VID_xxxx&PID_yyyy deve essere usato nel campo DIJOYCONFIG.wszType quando si chiama SetConfig.

Valore restituito

Restituisce DI_OK se ha esito positivo; in caso contrario, restituisce uno dei valori di errore COM seguenti:

Codice restituito	Descrizione
DIERR_NOTACQUIRED	La configurazione del joystick non è stata acquisita. È necessario chiamare IDirectInputJoyConfig8::Acquire prima di poter inviare notifiche alle applicazioni e ai driver delle modifiche apportate alla configurazione del joystick.
DIERR_INVALIDPARAM	Uno o più parametri non sono validi.
DIERR_READONLY	Tentativo di modificare un tipo predefinito.

Requisiti


Piattaforma di destinazione	Desktop
Intestazione	dinputd.h (include Dinputd.h)

Condividi tramite