IDirectInputDevice::GetObjectInfo

The IDirectInputDevice::GetObjectInfo method retrieves information about a device object such as a button or axis.

HRESULT GetObjectInfo(
  LPDIDEVICEOBJECTINSTANCE pdidoi,  
  DWORD dwObj,                      
  DWORD dwHow                       
);
 

Parameters

pdidoi

Address of a DIDEVICEOBJECTINSTANCE structure to be filled with information about the object. The structure's dwSize member must be initialized before this method is called.

dwObj

Value that identifies the object whose information will be retrieved. The value set for this parameter depends on the value specified in the dwHow parameter.

dwHow

Value specifying how the dwObj parameter should be interpreted. This value can be one of the following:

Value	Meaning
DIPH_DEVICE	The dwObj parameter must be zero.
DIPH_BYOFFSET	The dwObj parameter is the offset into the current data format of the object whose information is being accessed.
DIPH_BYID	The dwObj parameter is the object type/instance identifier. This identifier is returned in the dwType member of the DIDEVICEOBJECTINSTANCE structure returned from a previous call to the IDirectInputDevice::EnumObjects method.
DIPH_BYUSAGE	The dwObj parameter contains the HID Usage Page and Usage values of the object, combined by the DIMAKEUSAGEDWORD macro.

Return Values

If the method succeeds, the return value is DI_OK.

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

Remarks

For compatibility with DirectX 3, it is also valid to pass a DIDEVICEOBJECTINSTANCE_DX3 structure with the dwSize member initialized to sizeof(DIDEVICEOBJECTINSTANCE_DX3). For more information, see Designing for Previous Versions of DirectInput.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in dinput.h.
  Import Library: Use dinput.lib.