Microsoft DirectX 9.0

IDirectInputDevice8::GetCapabilities Method

Obtains the capabilities of the DirectInputDevice object.


HRESULT GetCapabilities(      

    LPDIDEVCAPS lpDIDevCaps );


Address of a DIDEVCAPS structure to be filled with the device capabilities. The dwSize member of this structure must be initialized before calling this method.

Return Value

If the method succeeds, the return value is DI_OK.

If the method fails, the return value can be one of the following error values:

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 Component Object Model (COM) return value.
DIERR_NOTINITIALIZEDThe object has not been initialized.
E_POINTERAn invalid pointer, usually NULL, was passed as a parameter.


For compatibility with Microsoft?DirectX?3, it is also valid to pass a DIDEVCAPS_DX3 structure with the dwSize member initialized to sizeof(DIDEVCAPS_DX3).

The number of objects returned in the DIDEVCAPS structure is the maximum number of objects that could be enumerated. However, all of these objects are not necessarily returned during a call to IDirectInputDevice8::EnumObjects.

© 2002 Microsoft Corporation. All rights reserved.