IDiscFormat2TrackAtOnce：：get_FreeSectorsOnMedia 方法 (imapi2.h)
擷取可用於將新曲目新增至媒體的磁區數目。
語法
HRESULT get_FreeSectorsOnMedia(
[out] LONG *value
);
參數
[out] value
媒體上可用於寫入音訊的可用磁區數目。
傳回值
S_OK會在成功時傳回，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：
| 傳回碼 | 描述 |
|---|---|
|
指標無效。
值：0x80004003 |
|
(IDiscFormat2TrackAtOnce：:P repareMedia 尚未呼叫媒體) 。
值：0xC0AA0502 |
備註
如果在 AddAudioTrack 作業期間呼叫，可用的磁區不會反映寫入目前曲目時所使用的磁區。相反地，報告值是在呼叫 AddAudioTrack 之前立即可用的磁區數目。
需求
| 最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | imapi2.h |
另請參閱
IDiscFormat2Data：：get_FreeSectorsOnMedia
IDiscFormat2Data：：get_TotalSectorsOnMedia