共用方式為


IDiscFormat2TrackAtOnce::CancelAddTrack 方法 (imapi2.h)

取消目前的寫入作業。

Syntax

HRESULT CancelAddTrack();

傳回值

成功時會傳回S_OK,但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回,但不代表唯一可能的錯誤值:

傳回碼 Description
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