Metodo IDirectInputJoyConfig8::OpenTypeKey (dinputd.h)

Articolo
03/05/2024

Il metodo IDirectInputJoyConfig8::OpenTypeKey apre la chiave del Registro di sistema associata a un tipo di joystick.

Sintassi

HRESULT OpenTypeKey(
  LPCWSTR unnamedParam1,
  DWORD   unnamedParam2,
  PHKEY   unnamedParam3
);

Parametri

unnamedParam1

Punta al nome del tipo. Il nome del tipo non può superare MAX_PATH caratteri, incluso il carattere Null terminante. Il nome non può iniziare con un carattere "#". I tipi che iniziano con "#" sono riservati da DirectInput.

unnamedParam2

Specifica una maschera di accesso al Registro di sistema. Questo può essere uno dei valori consentiti dalla funzione RegOpenKeyEx . Se viene richiesto l'accesso in scrittura, la configurazione del joystick deve essere stata prima acquisita. Se viene richiesto solo l'accesso in lettura, l'acquisizione non è necessaria.

unnamedParam3

Punta alla chiave del Registro di sistema aperta, in caso di esito positivo.

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 aprire una chiave di configurazione del tipo di joystick per la scrittura.
DIERR_INVALIDPARAM	Uno o più parametri non sono validi.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)	Codice di errore Win32 se l'accesso alla chiave viene negato dalle autorizzazioni del Registro di sistema o da un altro fattore esterno.

Commenti

Le applicazioni del pannello di controllo possono usare la chiave del Registro di sistema aperta da questo metodo per archiviare informazioni persistenti per tipo, ad esempio parametri di configurazione globali. Tali informazioni private devono essere mantenute in una sottochiave denominata OEM; non archiviare informazioni private nella chiave di tipo principale. Le applicazioni del pannello di controllo possono anche usare questa chiave per leggere le informazioni di configurazione, ad esempio le stringhe da usare per le richieste di calibrazione dei dispositivi. L'applicazione deve usare RegCloseKey per chiudere la chiave del Registro di sistema.

Requisiti

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

Condividi tramite