DIDEVICEIMAGEINFOHEADER Structure

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.

Structure Information

Header	dinput.h
Minimum operating systems	Windows 98