Microsoft DirectX 8.1 (Visual Basic)

DirectInputDevice8.BuildActionMap

Builds an action map for the device and retrieves information about it.

object.BuildActionMap( _
  format As DIACTIONFORMAT, _
  username As String, _
  flags As Long)

Parts

object
Resolves to a DirectInputDevice8 object.
format
DIACTIONFORMAT type that receives properties of the action map.
username
String that specifies the name of the user for whom mapping is requested. If an empty string, the current user is assumed.
flags
Flags used to control the mapping. Can be one of the constants of the CONST_DIDBAMFLAGS enumeration.

Error Codes

If the method fails, an error is raised and Err.Number may be one of the following error codes.

DIERR_INVALIDPARAM
DIERR_MAPFILEFAIL

Remarks

If DIERR_INVALIDPARAM is raised, one or more of the mappings was not valid. The lHow member of the DIACTION type is set to DIAH_ERROR. The application can iterate through the action map to find and correct errors.

See Also

DirectInputDevice8.SetActionMap, DirectInputDevice8.SetDataFormat