|Microsoft DirectX 9.0|
Retrieves the status of a specified device.
REFGUID rguidInstance );
- Reference to (C++) or address of (C) the globally unique identifier (GUID) identifying the instance of the device whose status is being checked.
If the method succeeds, the return value is DI_OK if the device is attached to the system, or DI_NOTATTACHED otherwise.
If the method fails, the return value can be one of the following error values:
DIERR_GENERIC An undetermined error occurred inside the Microsoft?DirectInput?subsystem. This value is equal to the E_FAIL standard Component Object Model (COM) return value. DIERR_INVALIDPARAM An invalid parameter was passed to the returning function, or the object was not in a state that permitted the function to be called. This value is equal to the E_INVALIDARG standard COM return value. DIERR_NOTINITIALIZED The object has not been initialized.