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

Artigo
02/29/2024

O método IDirectInputJoyConfig8::AddNewHardware exibe a caixa de diálogo Adicionar Novo Hardware que orienta o usuário na instalação de um novo dispositivo de entrada.

Sintaxe

HRESULT AddNewHardware(
  HWND    unnamedParam1,
  REFGUID unnamedParam2
);

Parâmetros

unnamedParam1

Manipule para a janela que funciona como a janela de proprietário para a interface do usuário.

unnamedParam2

GUID que especifica a classe do dispositivo de hardware a ser adicionado. O DirectInput vem com os SEGUINTEs GUIDs de classe já definidos:

GUID_KeyboardClass

Dispositivos de teclado.

GUID_MouseClass

Dispositivos de mouse.

GUID_MediaClass

Dispositivos de mídia, incluindo joysticks.

GUID_HIDClass

Dispositivos HID.

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_INVALIDPARAM	(E_INVALIDARG). Um ou mais parâmetros eram inválidos.
DIERR_INVALIDCLASSINSTALLER	O instalador de classe do dispositivo especificado não pôde ser encontrado ou é inválido.
DIERR_CANCELLED	O usuário cancelou a operação.
DIERR_BADINF	O arquivo INF do dispositivo selecionado pelo usuário não pôde ser encontrado ou inválido ou danificado.
S_FALSE	O DirectInput não pôde determinar se a operação foi concluída com êxito.

Requisitos

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