|Microsoft DirectX 9.0|
Retrieves the instance globally unique identifier (GUID) of a device that has been newly attached to the system. It is called in response to a Microsoft?Win32? device management notification.
REFGUID rguidClass, LPCTSTR ptszName, LPGUID pguidInstance );
- Unique identifier of the device class for the device that the application is to locate. The application obtains the class GUID from the device arrival notification. For more information, see the documentation on the DBT_DEVICEARRIVAL event in the Microsoft Platform Software Development Kit (SDK).
- Name of the device. The application obtains the name from the device arrival notification.
- Address of a variable to receive the instance GUID for the device, if the device is found. This value can be passed to IDirectInput8::CreateDevice.
If the method succeeds, the return value is DI_OK.
If the method fails, the return value can be DIERR_DEVICENOTREG. Failure results if the GUID and name do not correspond to a device class that is registered with Microsoft DirectInput? For example, they might refer to a storage device, rather than an input device.