Platform SDK: DirectX |
The IDirectInput7::CreateDeviceEx method creates and initializes an instance of a device based on a given GUID, and obtains an IDirectInputDevice, IDirectInputDevice2, or IDirectInputDevice7 interface.
HRESULT CreateDeviceEx( REFGUID rguid, REFIID riid, LPVOID *pvOut, LPUNKNOWN pUnkOuter );
For the preceding GUID values to be valid, your application must define INITGUID before all other preprocessor directives at the beginning of the source file, or link to Dxguid.lib.
If the method succeeds, the return value is DI_OK.
If the method fails, the return value can be one of the following:
DIERR_DEVICENOTREG |
DIERR_INVALIDPARAM |
DIERR_NOINTERFACE |
DIERR_NOTINITIALIZED |
DIERR_OUTOFMEMORY |
In C++ the rguid parameter must be passed by reference; in C, which does not permit passing by-reference, it must be passed by address. The following is an example of a C++ call:
lpdi->CreateDevice(GUID_SysKeyboard, &pdev, NULL);
The following shows the same call in C:
lpdi->lpVtbl->CreateDevice(lpdi, &GUID_SysKeyboard, &pdev, NULL);
Most applications will want to pass IID_IDirectInputDevice7 in the riid parameter to obtain the IDirectInputDevice7 interface.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
Header: Declared in dinput.h.
Import Library: Use dinput.lib.