DIACTIONFORMAT
Specifies and receives information about an action map.
Type DIACTIONFORMAT
ActionArray() As DIACTION
ActionMapName As String
guidActionMap As String
lActionCount As Long
lAxisMax As Long
lAxisMin As Long
lBufferSize As Long
lDataSize As Long
lGenre As Long
End Type
Members
- ActionArray
- Array of DIACTION types, each of which describes how an action maps to a virtual control or device object, and how the mapping information should be displayed to the user.
- ActionMapName
- Friendly name for the action map.
- guidActionMap
- GUID that identifies the action map. This value can be used by device manufacturers to tune mappings for a specific title.
- lActionCount
- Number of elements in ActionArray.
- lAxisMax
- Maximum value for the range of scaled data to be returned for all axes. This value is ignored for a specific action axis if the DIA_NORANGE flag is set in the DIACTION type for that action. See Remarks.
- lAxisMin
- Minimum value for the range of scaled data to be returned for all axes. This value is ignored for a specific action axis if the DIA_NORANGE flag is set in the DIACTION type for that action. See Remarks.
- lBufferSize
- Value that specifies the number of input data packets in the buffer for each device to which this action map is applied. See Remarks.
- lDataSize
- Value that specifies the size of immediate data to be returned by the device, in bytes. When this type is passed to DirectInputDevice8.SetActionMap, this value should be four times the number of elements in the array of DIACTION types passed to the method.
- lGenre
- Genre of the application. One of the members of the CONST_DIGENRE enumeration whose names begin with DIVIRTUAL.
Remarks
The lAxisMax and lAxisMin members are valid only for axis actions and should be set to zero for all other actions. Setting them before passing this type to DirectInputDevice8.SetActionMap is equivalent to setting the range properties by passing a DIPROPRANGE type to DirectInputDevice8.SetProperty.
The buffer size must be set to a value greater than zero if you want to retrieve data by using DirectInputDevice8.GetDeviceData. Applications that set the lBufferSize member to the desired buffer size before passing this type to DirectInputDevice8.SetActionMap do not need to set the DIPROP_BUFFERSIZE property by using DirectInputDevice8.SetProperty.