IDirectInput8::GetDeviceStatus Method

Retrieves the status of a specified device.

Syntax

HRESULT GetDeviceStatus(      

    REFGUID rguidInstance
);

Parameters

rguidInstance
Reference to (C++) or address of (C) the globally unique identifier (GUID) identifying the instance of the device whose status is being checked.

Return Value

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.

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.