PTBurn
SDK
Page
12
of
68
©
2011
Primera
Technology,
Inc.
Primera
is
a
registered
trademark
and
Bravo
is
a
trademark
of
Primera
Technology,
Inc.
All
other
trademarks
are
the
property
of
their
respective
companies.
Possible
values:
Message
Disabled
The
default
value
is
Disabled
if
this
key
is
not
given.
When
a
value
of
Message
is
given
then
the
client
will
be
notified
via
a
net
message.
If
this
feature
is
used,
the
ClientID
key
must
be
set
to
the
client’s
computer
name.
This
function
works
for
Windows
XP
but
not
Windows
Vista
or
Windows
7.
2.1.18
PreserveISOVariations
This
key
forces
the
recording
engine
to
preserve
the
file
name
as
is
even
if
it
is
out
of
specification.
Possible
values:
YES
NO
The
default
value
is
NO
if
this
key
is
not
given.
2.1.19
ReadDataTo
This
key
specifies
the
location
to
which
data
from
the
disc(s)
should
be
stored
(this
is
useful
for
saving
the
contents
of
a
disc
for
later
use).
If
the
ReadDataFormat
key
is
set
to
ReadData,
then
this
key
contains
the
path
of
where
the
data
from
the
disc
should
be
written
to
the
hard
disk
drive
(ex.
C:\MyDisc1).
If
ReadDataFormat
is
ReadGI,
then
ReadDataTo
specifies
the
path
and
GI
file
name
that
should
be
created
(ex.
\\Computer\PTBurnJobs\ReadFile
would
create
the
global
image
file
\\Computer\PTBurnJobs\ReadFile.gi
).
When
using
ReadGI
as
the
format
you
should
NOT
specify
the
.gi
extension
in
the
ReadDataTo
key
because
PTBurn
will
append
the
.gi
extension
to
the
name.
2.1.20
ReadDataFormat
This
key
specifies
the
format
in
which
the
disc(s)
will
be
stored
onto
the
hard
disk
drive
(into
the
location
specified
by
ReadDataTo).
The
possible
values
are
as
follows:
ReadGI
ReadData
The
default
value
is
ReadData,
which
will
read
the
data
from
the
disc
and
store
the
same
data
onto
the
hard
disk
drive.
ReadGI
will
create
a
Global
Image
file
of
the
Disc.
If
the
format
is
ReadGI
and
the
number
of
copies
is
greater
than
1,
then
a
_0,
_1…
will
be
appended
to
the
GI
filename.
NOTE:
any
files,
including
.GI
files
will
be
overwritten
if
they
already
exist.
2.1.21
CreateSubFolders
This
key
will
cause
PTBurn
to
create
a
subfolder
below
the
ReadDataTo
path
for
each
disc
read.
The
subfolders
will
be
named
Disc_0,
Disc_1
…
The
possible
values
are:
YES
NO
The
default
value
is
NO
if
this
key
is
not
given.
This
key
is
only
valid
if
ReadDataTo
is
specified,
ReadDataFormat
=
ReadData,
and
the
number
of
copies
is
greater
than
1.
NOTE:
Before
starting
the
job,
the
subfolders
Disc_0,
Disc_1,
…,
should
be
deleted,
renamed,
or
moved
if
they
already
exist
in
the
location
specified
by
ReadDataTo.