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

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)