IDirectInputJoyConfig8::AddNewHardware-Methode (dinputd.h)

  • Artikel

Die IDirectInputJoyConfig8::AddNewHardware-Methode zeigt das Dialogfeld Neue Hardware hinzufügen an, das den Benutzer durch die Installation eines neuen Eingabegeräts führt.

Syntax

HRESULT AddNewHardware(
  HWND    unnamedParam1,
  REFGUID unnamedParam2
);

Parameter

unnamedParam1

Handle mit dem Fenster, das als Besitzerfenster für die Benutzeroberfläche fungiert.

unnamedParam2

GUID, die die Klasse des hinzuzufügenden Hardwaregeräts angibt. DirectInput enthält die folgenden bereits definierten Klassen-GUIDs:

GUID_KeyboardClass

Tastaturgeräte.

GUID_MouseClass

Mausgeräte.

GUID_MediaClass

Mediengeräte, einschließlich Joysticks.

GUID_HIDClass

HID-Geräte.

Rückgabewert

Gibt bei erfolgreicher Ausführung DI_OK zurück. gibt andernfalls einen der folgenden COM-Fehlerwerte zurück:

Rückgabecode Beschreibung
DIERR_INVALIDPARAM
(E_INVALIDARG). Mindestens ein Parameter war ungültig.
DIERR_INVALIDCLASSINSTALLER
Das Klasseninstallationsprogramm für das angegebene Gerät konnte nicht gefunden werden oder ist ungültig.
DIERR_CANCELLED
Der Benutzer hat den Vorgang abgebrochen.
DIERR_BADINF
Die INF-Datei für das Gerät, das der Benutzer ausgewählt hat, konnte nicht gefunden werden, ist ungültig oder beschädigt.
S_FALSE
DirectInput konnte nicht ermitteln, ob der Vorgang erfolgreich abgeschlossen wurde.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dinputd.h (include Dinputd.h)