IDiscFormat2TrackAtOnce::put_DoNotFinalizeMedia method (imapi2.h)
Determines if the media is left open for writing after writing the audio track.
Syntax
HRESULT put_DoNotFinalizeMedia(
[in] VARIANT_BOOL value
);
Parameters
[in] value
Set to VARIANT_TRUE to leave the media open for writing after writing the audio track; otherwise, VARIANT_FALSE. The default is VARIANT_FALSE.
Return value
S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:
| Return code | Description |
|---|---|
|
A write operation is in progress.
Value: 0xC0AA0500 |
|
The requested operation is not valid when media has been "prepared" but not released.
Value: 0xC0AA0503 |
|
The property cannot be changed once the media has been written to.
Value: 0xC0AA0504 |
Remarks
You can set this property before calling the IDiscFormat2TrackAtOnce::PrepareMedia method or after calling the IDiscFormat2TrackAtOnce::ReleaseMedia method; you cannot set it during a track-writing session.
This property is useful to create a multi-session CD with audio in the first session and data in the second session.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista, Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | imapi2.h |
See also
IDiscFormat2TrackAtOnce::PrepareMedia