|
MidiDjConsole.ProfileSave method |
  
|
|
MidiDjConsole.ProfileSave method |
|
Remarks
Saves the current profile, written for a specific DJ Console and loaded into the instance of the component, into a XML file for later usage. A saved profile can be reloaded at a later time through the MidiDjConsole.ProfileLoad method.
Due to the fact that the profile will contain the product and vendor identifiers for a specific DJ Console, the usage of this methods requires the DJ Console to be physically connected to the system and also connected to the instance of the component through a previous call to the MidiDjConsole.Connect method. In case the DJ Console shouldn't be physically connected to the system or connected to the instance of the component, you could in any case save the profile while "offline" through the MidiDjConsole.ProfileSaveWithoutDevice method.
The XML file is normally saved in ANSI format: in case one or more of the saved strings should contain UNICODE characters, the file would be automatically saved in UTF-8 format.
For further details about interfacing with MIDI DJ Consoles see the MidiDjConsole object section and the How to manage MIDI DJ consoles tutorial.
Syntax
[Visual Basic] control.MidiDjConsole.ProfileSave ( strPathname as String, bStoreHexValues as enumBoolean ) as enumDjcErrorCodes |
[C++] short control.MidiDjConsole.ProfileSave ( BSTR strPathname, short bStoreHexValues ); |
Parameter |
Description |
|||||||||
|
|
|||||||||
strPathname |
String representing the absolute pathname of the destination XML file to save. |
|||||||||
bStoreHexValues |
Boolean value that specifies if the numerical values of the various profile's items are stored inside the file as decimal or hexadecimal values. Supported values are the following:
|
Return value
Value |
Meaning |
|
|
enumDjcErrorCodes.ERR_DJC_NOERROR (0) |
The call was successful. |
Negative value |
An error occurred: see the LastError property for further error details or for a list of the possible error values. |
