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

  • Artigo

O método IDirectInputJoyConfig8::OpenTypeKey abre a chave do Registro associada a um tipo de joystick.

Sintaxe

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

Parâmetros

unnamedParam1

Aponta para o nome do tipo. O nome do tipo não pode exceder MAX_PATH caracteres, incluindo o caractere nulo de terminação. O nome não pode começar com um caractere "#". Os tipos que começam com "#" são reservados pelo DirectInput.

unnamedParam2

Especifica uma máscara de acesso de segurança do Registro. Isso pode ser qualquer um dos valores permitidos pela função RegOpenKeyEx . Se o acesso de gravação for solicitado, a configuração do joystick deverá primeiro ter sido adquirida. Se apenas o acesso de leitura for solicitado, a aquisição não será necessária.

unnamedParam3

Aponta para a chave do Registro aberta, em caso de êxito.

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 abrir uma chave de configuração do tipo joystick para gravação.
DIERR_INVALIDPARAM
Um ou mais parâmetros eram inválidos.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
Um código de erro Win32 se o acesso à chave for negado por permissões do Registro ou algum outro fator externo.

Comentários

Os aplicativos do painel de controle podem usar a chave do Registro aberta por esse método para armazenar informações persistentes por tipo, como parâmetros de configuração global. Essas informações privadas devem ser mantidas em uma subchave chamada OEM; não armazene informações privadas na chave de tipo main. Os aplicativos do painel de controle também podem usar essa chave para ler informações de configuração, como as cadeias de caracteres a serem usadas para prompts de calibragem do dispositivo. O aplicativo deve usar RegCloseKey para fechar a chave do Registro.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dinputd.h (inclua Dinputd.h)