dinput.dllGetDeviceInfo
Microsoft DirectX 9.0 SDK Update (October 2004)

IDirectInputDevice8::GetDeviceInfo Method


Obtains information about the device's identity.

Syntax

HRESULT GetDeviceInfo(      

    LPDIDEVICEINSTANCE pdidi );

Parameters

pdidi
Address of a DIDEVICEINSTANCE structure to be filled with information about the device's identity. An application must initialize the structure's dwSize member 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.


Remarks

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



© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.