Microsoft DirectX 8.1 (C++) |
IDirectInput8::CreateDevice
Creates and initializes an instance of a device based on a given GUID, and obtains an IDirectInputDevice8 interface.
HRESULT CreateDevice( REFGUID rguid, LPDIRECTINPUTDEVICE *lplpDirectInputDevice, LPUNKNOWN pUnkOuter );
Parameters
- rguid
- Reference to (C++) or address of (C) the instance GUID for the desired input device (see Remarks). The GUID is retrieved through the IDirectInput8::EnumDevices method, or it can be one of the following predefined GUIDs:
- GUID_SysKeyboard
- The default system keyboard.
- GUID_SysMouse
- The default system mouse.
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.
- lplpDirectInputDevice
- Address of a variable to receive the IDirectInputDevice8 interface pointer if successful.
- pUnkOuter
- Address of the controlling object's IUnknown interface for COM aggregation, or NULL if the interface is not aggregated. Most callers pass NULL.
Return Values
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 |
Remarks
Calling this method with pUnkOuter = NULL is equivalent to creating the object by CoCreateInstance(&CLSID_DirectInputDevice, NULL, CLSCTX_INPROC_SERVER, riid, lplpDirectInputDevice) and then initializing it with Initialize.
Calling this method with pUnkOuter != NULL is equivalent to creating the object by CoCreateInstance(&CLSID_DirectInputDevice, punkOuter, CLSCTX_INPROC_SERVER, &IID_IUnknown, lplpDirectInputDevice). The aggregated object must be initialized manually.
Requirements
Windows NT/2000/XP: Requires Windows® 2000.
Windows 98/Me: Requires Windows 98 or later. Available as a redistributable for Windows 98.
Header: Declared in Dinput.h.