Compartir a través de

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

  • Artículo

El método IDirectInputJoyConfig8::OpenTypeKey abre la clave del Registro asociada a un tipo de joystick.

Sintaxis

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

Parámetros

unnamedParam1

Apunta al nombre del tipo. El nombre del tipo no puede superar MAX_PATH caracteres, incluido el carácter nulo de terminación. El nombre no puede comenzar con un carácter "#". Los tipos que comienzan por "#" están reservados por DirectInput.

unnamedParam2

Especifica una máscara de acceso de seguridad del Registro. Puede ser cualquiera de los valores permitidos por la función RegOpenKeyEx . Si se solicita acceso de escritura, primero se debe haber adquirido la configuración del joystick. Si solo se solicita acceso de lectura, no se requiere la adquisición.

unnamedParam3

Apunta a la clave del Registro abierta, si se realiza correctamente.

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 de joystick. Debes llamar a IDirectInputJoyConfig8::Acquire para poder abrir una clave de configuración de tipo joystick para escribir.
DIERR_INVALIDPARAM
Uno o varios parámetros no eran válidos.
MAKE_HRESULT(SEVERITY_ERROR, FACILITY_WIN32, ErrorCode)
Un código de error win32 si se deniega el acceso a la clave mediante permisos del Registro o algún otro factor externo.

Comentarios

Las aplicaciones del panel de control pueden usar la clave del Registro abierta por este método para almacenar información persistente por tipo, como parámetros de configuración global. Dicha información privada debe mantenerse en una subclave denominada OEM; no almacene información privada en la clave de tipo principal. Las aplicaciones del panel de control también pueden usar esta clave para leer la información de configuración, como las cadenas que se usarán para los mensajes de calibración del dispositivo. La aplicación debe usar RegCloseKey para cerrar la clave del Registro.

Requisitos

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