DICONFIGUREDEVICESPARAMS

Contains information for the device configuration property sheet. It is used by the DirectInput8.ConfigureDevices method.

Type DICONFIGUREDEVICESPARAMS
    ActionFormats() As DIACTIONFORMAT
    DDSTarget As Unknown
    dics As DICOLORSET
    FormatCount As Long
    hwnd As Long
    UserCount As Long
    UserNames() As String
End Type

Members

ActionFormats

Array of DIACTIONFORMAT types that contains action-mapping information for each genre used by the game. On input, this array contains action-to-control mappings and strings to display as callouts for each mapping. The configuration interface displays the genres in its drop-down list in the same order as in the array.

DDSTarget

Direct3DSurface8 object for the configuration user interface. The device image is alpha-blended over the background surface onto the target surface.

Applications that are not using DirectDraw and applications that are using DirectDraw but are windowed rather than using the full screen may pass NULL in this parameter. This will cause Microsoft DirectInput® to use the Windows Graphics Device Interface (GDI) functions to draw the configuration user interface image.

dics

DICOLORSET type that describes the color scheme to apply to the configuration user interface.

FormatCount

Number of elements in the ActionFormats array.

hwnd

Handle to the top-level window of the calling application. The member is needed only for applications that run in windowed mode, and is otherwise ignored.

UserCount

Number of elements in the UserNames array. Zero is an invalid value. If the UserCount value exceeds the number of entries actually in the array at UserNames(), the method fails, returning DIERR_INVALIDPARAM. If the UserNames array is set to NULL, the value in UserCount is ignored.

UserNames

Array of user names. This parameter can be set to NULL to request default names, the number of which is determined by UserCount. If the application passes more than UserCount names, only the names within the count are used. If an application specifies names that are different from the names currently assigned to devices, ownership is revoked for all devices, a default name is created for the mismatched name, and the interface shows "(No User)" for all devices.