Microsoft DirectX 9.0

IDirectInput8::GetDeviceStatus Method

Retrieves the status of a specified device.


HRESULT GetDeviceStatus(      

    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.

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_GENERICAn undetermined error occurred inside the Microsoft?DirectInput?subsystem. This value is equal to the E_FAIL standard Component Object Model (COM) return value.
DIERR_INVALIDPARAMAn 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_NOTINITIALIZEDThe object has not been initialized.

© 2002 Microsoft Corporation. All rights reserved.