Metodo IDirectInputJoyConfig8::GetConfig (dinputd.h)

Articolo
02/29/2024

Il metodo IDirectInputJoyConfig8::GetConfig ottiene informazioni sulla configurazione di un joystick.

Sintassi

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

Parametri

unnamedParam1

Indica un numero di identificazione del joystick. Quest'ultimo è un numero intero non negativo. Per enumerare i joystick, iniziare con il joystick zero e aumentare il numero del joystick per uno fino a quando la funzione restituisce DIERR_NOMOREITEMS.

unnamedParam2

Punta a una struttura che riceve informazioni sulla configurazione del joystick. Il chiamante "must" inizializza il membro dwSize della struttura DIJOYCONFIG prima di chiamare questo metodo.

unnamedParam3

Specifica i membri della struttura puntati da pjc che devono essere compilati. Questo parametro può essere zero, uno o più dei seguenti:

DIJC_GUIDINSTANCE

Indica che viene richiesto il GUID dell'istanza per il joystick. Un'applicazione può passare il GUID dell'istanza a IDirectInput::CreateDevice per ottenere un'interfaccia IDirectInputDevice al joystick. Si noti che questo flag non è un parametro valido per IDirectInputJoyConfig8::SetConfig.

DIJC_REGHWCONFIGTYPE

Indica che la configurazione hardware per il joystick (membro hwc della struttura DIJOYCONFIG) e il nome del tipo di joystick (membro wszType della stessa struttura) vengono richiesti. Si noti che la configurazione hardware e il nome del tipo non possono essere recuperati separatamente.

DIJC_GAIN

Indica che viene richiesto il guadagno di forza-feedback per il joystick.

DIJC_CALLOUT

Indica che viene richiesto il callout del polling del joystick.

Valore restituito

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

Codice restituito	Descrizione
DIERR_INVALIDPARAM	Uno o più parametri non sono validi.
S_FALSE	Il joystick specificato non è ancora stato configurato.
DIERR_NOMOREITEMS	Non sono disponibili altri joystick.

Requisiti

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

Condividi tramite