|
|
|
|
|
|
|
|
|
|
- Procedure used to manage the different events that occur
- Sessions and tracks
- Compilation
- Burned audio CD/DVD
- Required configuration
Burns the files found in the compilation onto the CD or DVD. During the burn process, BurnerSave regularly calls a specific WLanguage procedure. This procedure is used to manage the different events that occur during the burn process. Remarks: - After BurnerSave is called, the current compilation is automatically deleted.
- This function is not locking. To find out if the burning is complete, use the WLanguage procedure regularly called by BurnerSave.
ResBurn is boolean
ResBurn = BurnerSave(burnerAutoEject, ProcBurnCD)
Sintaxis
<Result> = BurnerSave(<Burn options> [, <WLanguage procedure> [, <Pointer>]])
<Result>: Boolean - True if the files are currently burnt onto the CD or DVD,
- False otherwise. To get more details on the error, use ErrorInfo.
To find out if the burning is complete, test the event encountered in the <Procedure name> procedure.
Note: A CD or DVD must be present in the recorder.. This CD/DVD must contain enough space to burn a new session.
<Burn options>: Integer constant (or combination of constants) Option for burning files on the CD or DVD: | | | burnerAutoEject | Opens the burner door at the end of burn process. | | burnerFinalize | Finalize the media: any further writing on the media will be forbidden.
Note: Rewritable media can still be erased and reused. | | burnerNoEject | Does not open the burner door at the end of burn process. | | burnerSimulate | Simulates the burning of CD or DVD. All the steps of the burn process are performed except for the actual burning of files on the CD/DVD. |
By default, the files are actually burned on the CD/DVD (no simulation) and the burner door is not opened at the end of burn process. <WLanguage procedure>: Optional procedure name Name of the WLanguage procedure ("callback") regularly called during the burn process. This procedure is used to manage the different events that occur.
This procedure has the following format:PROCEDURE <Procedure name>(<Event encountered>, <Event message>, <Procedure pointer>, <Parameter 1>, <Parameter 2>) The parameters of this procedure are optional. There is no need to pass parameters to this procedure. Indeed, these parameters are automatically filled whenever a file is processed. <Pointer>: Optional integer Pointer passed to <Procedure name>. Observaciones Procedure used to manage the different events that occur BurnerSave regularly calls the <Procedure name> procedure. This procedure is used to manage the different events that occur during the burn process. This procedure is a local or global procedure. This procedure must be declared as follows: PROCEDURE <Procedure name>(<Event encountered>, <Event message>, <Procedure pointer>, <Parameter 1>, <Parameter 2>) - <Event encountered> is a constant indicating the type of event.
- <Event message> is a character string containing the message of the event encountered.
- <Procedure pointer> is an integer whose value is the one passed to the <Pointer> parameter of BurnerSave. If <Pointer> is not specified, <Pointer> is set to 0.
- <Parameter 1> and <Parameter 2> are integers containing a value specific to the event that occurred.
The different values are as follows: | | | | | | Event | <Event encountered> | <Event message> | <Parameter 1> | <Parameter 2> |
|---|
| Cancel the burn process | burnerNotificationCancel | "" | 0 | 0 | | Error detected | burnerNotificationError | Error message | Code of error that occurred | 0 | | Close the CD/DVD | burnerNotificationCloseCD | "" | Duration (in seconds) for closing the CD/DVD | 0 | | Burn process completed | burnerNotificationEndBurning | Error message if <Parameter 1> is different from 0, empty string ("") otherwise | Return code, 0 if no error | 0 | | Burn a block | burnerNotificationBurnBlock | "" | Rank of the current block | Total number of blocks to burn | | Burn a track | burnerNotificationBurnTrack | "" | Rank of the current track | Total number of tracks to burn | | Prepare to burn | burnerNotificationPrepareBurning | "" | Duration (in seconds) for preparing to burn | 0 | | Other event | | Event message | Rank of the current step | Total number of steps to perform |
To get the value of <Procedure pointer>, its value must be assigned to the value of <Pointer> in the procedure with Transfer. Note The parameters of this procedure are optional: for example, you can specify only the event and the message. Sessions and tracks The CDs/DVDs are divided into sessions and tracks. A session corresponds to all the files burned at the same time during a single operation. A track corresponds to a file. A session can contain one or more tracks. Each new burn operation on the same CD/DVD generates a new session on the CD/DVD. Note In the case of an audio CD/DVD, some CD/DVD players may only play tracks from the first session. Compilation A compilation corresponds to the set of files that must be burned on a CD or DVD. This compilation will be taken into account next time BurnerSave is called. A compilation is automatically deleted: - when changing the type of CD/DVD to burn (BurnerMediaType).
- when selecting the default burner (BurnerSelect).
- after the call to BurnerSave (only if the burn process was started, <Result> is set to True).
- when canceling the burn process (BurnerCancel).
- when closing the current WINDEV application or WEBDEV website.
Burned audio CD/DVD You cannot burn a compilation on an audio CD/DVD that is already burned.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|