Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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