DIDEVICEIMAGEINFOHEADER

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

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

Requirements

  Windows NT/2000/XP: Requires Windows 2000.
  Windows 98/Me: Requires Windows 98 or later. Available as a redistributable for Windows 98.
  Header: Declared in Dinput.h.