83Plus:Software:usb8x/Asm Interface/MSD/MSD ImportVariable - Revision history

Dan Englender: flags a->b

2006-09-10T02:19:29Z

flags a->b

Brandonw at 21:10, 17 August 2006

2006-08-17T21:10:49Z

Brandonw at 19:45, 17 August 2006

2006-08-17T19:45:43Z

Brandonw at 19:41, 17 August 2006

2006-08-17T19:41:33Z

New page

== Synopsis ==
'''Name:''' MSD_ImportVariable

'''Minimum usb8x version:''' 0.10

Imports *.8x* file from specified directory and stores in RAM/Flash.

=== Inputs ===
* HL points to an ASCIIZ string of *.8x* file (path included)
* A is flags byte
{| border="1" cellpadding="2" cellspacing="0"
|-
|Bit 0 || Set if existing variable should be deleted if duplicate is found; reset otherwise
|-
|Bit 1 || Set if variable should be created in Flash; reset if in RAM
|}

=== Outputs ===
* Variable is created in RAM or Flash
* C set if problems
* Returns C set if duplicate variable was found

=== Destroys ===
* AF, BC, DE, HL

== Notes ==
This works with both file and folder names.
Example code to import "game.8xp" in the root directory to RAM:
<code>
ld hl,sFilename
xor a ;do not overwrite existing variable and create in RAM
U_CALL MSD_ImportVariable
...
sFilename: DB "/game.8xp",0
</code>
If you are writing an application, you must copy the strings you use to RAM first, or else usb8x will not be able to see them.

== See Also ==
* [[../MSD_ExportVariable|MSD_ExportVariable]] - Export variable in RAM/Flash to specified directory as *.8x* file

@@ Line 8: / Line 8: @@
 === Inputs ===
 * HL points to an ASCIIZ string of *.8x* file (path included)
-* A is flags byte
+* B is flags byte
 {| border="1" cellpadding="2"  cellspacing="0"
 |-
@@ Line 28: / Line 28: @@
 <code>
   ld hl,sFilename
-  xor a ;do not overwrite existing variable and create in RAM
+  ld b,0 ;do not overwrite existing variable and create in RAM
   U_CALL MSD_ImportVariable
   ...

@@ Line 11: / Line 11: @@
 {| border="1" cellpadding="2"  cellspacing="0"
 |-
-|Bit 0 || Set if existing variable should be deleted if duplicate is found; reset otherwise
+|Bit 0 || Set if existing variable should be deleted if duplicate is found
 |-
 |Bit 1 || Set if variable should be created in Flash; reset if in RAM

@@ Line 25: / Line 25: @@
 == Notes ==
 Example code to import "game.8xp" in the root directory to RAM:
 <code>