DIDEVICEIMAGEINFOHEADER Structure

  • Article

Contains information about device images. Used in the IDirectInputDevice8::GetImageInfo method.

Syntax

typedef struct DIDEVICEIMAGEINFOHEADER {
    DWORD dwSize;
    DWORD dwSizeImageInfo;
    DWORD dwcViews;
    DWORD dwcButtons;
    DWORD dwcAxes;
    DWORD dwcPOVs;
    DWORD dwBufferSize;
    DWORD dwBufferUsed;
    DIDEVICEIMAGEINFO * lprgImageInfoArray;
} DIDEVICEIMAGEINFOHEADER, *LPDIDEVICEIMAGEINFOHEADER;

Members

  • dwSize
    DWORD value that specifies the size of this structure, in bytes. Must be initialized before the structure can be used.
  • dwSizeImageInfo
    DWORD value that specifies the size of the DIDEVICEIMAGEINFO structure, in bytes. Must be initialized before this structure can be used.
  • dwcViews
    DWORD variable that receives the number of views of this device.
  • dwcButtons
    DWORD variable that receives the number of buttons on the device.
  • dwcAxes
    DWORD variable that receives the number of axes on the device.
  • dwcPOVs
    DWORD variable that receives the number of point-of-view controllers on the device.
  • dwBufferSize
    DWORD value that specifies the size, in bytes, of the buffer at lprgImageInfoArray. When set to zero, the IDirectInputDevice8::GetImageInfo method ignores all other members and returns the minimum buffer size required to hold information for all images.
  • dwBufferUsed
    DWORD value that receives the size, in bytes, of the memory used in the buffer at lprgImageInfoArray. When dwBufferSize is set to zero, the IDirectInputDevice8::GetImageInfo method sets this member to the minimum size needed to hold information for all images.
  • lprgImageInfoArray
    Pointer to a buffer that receives an array of DIDEVICEIMAGEINFO structures describing all the device images and views, overlay images, and callout-string coordinates.

Remarks

The buffer at lprgImageInfoArray must be large enough to hold all required image information structures. Applications can query for the required size by calling the IDirectInputDevice8::GetImageInfo method with the dwBufferSize member set to zero. After the call, dwBufferUsed contains the amount of memory, in bytes, that was modified.