IDiscFormat2TrackAtOnce::CancelAddTrack 方法 (imapi2.h)

取消当前写入操作。

语法

HRESULT CancelAddTrack();

返回值

成功后返回S_OK,但实现后可能会返回其他成功代码。 以下错误代码通常在操作失败时返回,但不表示唯一可能的错误值:

返回代码 说明
E_IMAPI_DF2TAO_WRITE_NOT_IN_PROGRESS
当前没有正在进行的写入操作。

值:0xC0AA0501

E_FAIL
未知故障。

值:0x80004005

注解

若要取消写入操作,必须从实现的 DDiscFormat2TrackAtOnceEvents::Update 事件处理程序调用此方法。

在调用此方法后,还必须调用 IDiscFormat2TrackAtOnce::ReleaseMedia 方法。

请注意,由于特定于媒体的要求,调用此方法不会立即取消所有介质上的写入操作。 例如,写入 CD 时,写入操作最多可以再持续三分钟。

此方法可能会导致已录制部分音频曲目。 方法将尝试使媒体保持可用状态,并将取消的曲目视为比 IStream 最初描述的要短。 调用方应在取消后查询曲目数和轨道大小,以确定光盘状态。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 imapi2.h

另请参阅

IDiscFormat2TrackAtOnce

IDiscFormat2TrackAtOnce::AddAudioTrack