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

  • Artículo

El método IDirectInputJoyConfig8::AddNewHardware muestra el cuadro de diálogo Agregar nuevo hardware que guía al usuario a través de la instalación de un nuevo dispositivo de entrada.

Sintaxis

HRESULT AddNewHardware(
  HWND    unnamedParam1,
  REFGUID unnamedParam2
);

Parámetros

unnamedParam1

Identificador de la ventana que funciona como ventana propietaria de la interfaz de usuario.

unnamedParam2

GUID que especifica la clase del dispositivo de hardware que se va a agregar. DirectInput incluye los SIGUIENTES GUID de clase ya definidos:

GUID_KeyboardClass

Dispositivos de teclado.

GUID_MouseClass

Dispositivos del mouse.

GUID_MediaClass

Dispositivos multimedia, incluidos los joysticks.

GUID_HIDClass

Dispositivos HID.

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_INVALIDPARAM
(E_INVALIDARG). Uno o varios parámetros no eran válidos.
DIERR_INVALIDCLASSINSTALLER
No se encontró el instalador de clase para el dispositivo especificado o no es válido.
DIERR_CANCELLED
El usuario canceló la operación.
DIERR_BADINF
El archivo INF del dispositivo que el usuario seleccionado no se encontró o no es válido o está dañado.
S_FALSE
DirectInput no pudo determinar si la operación se completó correctamente.

Requisitos

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