?/TD>
Microsoft DirectX 9.0

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_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.