IDiscFormat2Data：：get_TotalSectorsOnMedia 方法 (imapi2.h)

擷取裝置中媒體上的扇區數目。

語法

HRESULT get_TotalSectorsOnMedia(
  [out] LONG *value
);

參數

[out] value

裝置媒體上的扇區數目。 此數目包括免費扇區、已使用扇區和開機扇區。

傳回值

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

傳回碼	Description
E_INVALIDARG	一或多個自變數無效。 值：0x80070057
E_POINTER	指標無效。 值：0x80004003
E_FAIL	未指定的失敗。 值：0x80004005
E_OUTOFMEMORY	無法配置所需的記憶體。 值：0x8007000E
E_IMAPI_RECORDER_COMMAND_TIMEOUT	裝置無法在逾時期間內接受命令。 這可能是裝置進入不一致的狀態所造成，或命令的逾時值可能需要增加。 值：0xC0AA020D
E_IMAPI_RECORDER_INVALID_RESPONSE_FROM_DEVICE	裝置回報命令的非預期或無效數據。 值：0xC0AA02FF
E_IMAPI_RECORDER_MEDIA_UPSIDE_DOWN	媒體會由上而下插入。 值：0xC0AA0204
E_IMAPI_RECORDER_MEDIA_BECOMING_READY	磁碟驅動器回報它正在準備中。 請稍後再試一次要求。 值：0xC0AA0205
E_IMAPI_RECORDER_MEDIA_NO_MEDIA	裝置中沒有媒體。 值：0xC0AA0202
E_IMAPI_RECORDER_MEDIA_FORMAT_IN_PROGRESS	媒體目前正在格式化。 請先等候格式完成，再嘗試使用媒體。 值：0xC0AA0206
E_IMAPI_RECORDER_MEDIA_BUSY	磁碟驅動器回報正在執行長時間執行的作業，例如完成寫入。 磁碟驅動器可能長時間無法使用。 值：0xC0AA0207
E_IMAPI_LOSS_OF_STREAMING	寫入失敗，因為磁碟驅動器未快速收到足以繼續寫入的數據。 將源數據移至本機計算機、減少寫入速度，或啟用「緩衝區無執行」設定可能會解決此問題。 值：0xC0AA0300
E_IMAPI_RECORDER_MEDIA_INCOMPATIBLE	媒體不相容或未知的實體格式。 值：0xC0AA0203
E_IMAPI_RECORDER_DVD_STRUCTURE_NOT_PRESENT	DVD 結構不存在。 這可能是因為使用不相容的磁碟驅動器/媒體所造成。 值：0xC0AA020E
E_IMAPI_RECORDER_NO_SUCH_MODE_PAGE	裝置回報要求的模式頁面 (，且類型) 不存在。 值：0xC0AA0201
E_IMAPI_RECORDER_INVALID_MODE_PARAMETERS	磁碟驅動器報告不支援MODE SELECT 命令的模式頁面中提供的參數組合。 值：0xC0AA0208
E_IMAPI_RECORDER_MEDIA_WRITE_PROTECTED	磁碟驅動器回報媒體受到寫入保護。 值：0xC0AA0209
E_IMAPI_RECORDER_MEDIA_SPEED_MISMATCH	媒體的速度與裝置不相容。 這可能是因為使用比裝置支援的速度範圍還要高或較低的速度媒體所造成。 值：0xC0AA020F
HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE)	指定的句柄無效。 值：6
HRESULT_FROM_WIN32 (ERROR_DEV_NOT_EXIST)	指定的網路資源或裝置已不再可用。 值：55
E_IMAPI_RECORDER_LOCKED	上次作業期間與此錄製器相關聯的裝置已獨佔鎖定，導致此作業失敗。 值：0xC0AA0210
E_IMAPI_DF2DATA_INVALID_MEDIA_STATE	要求的作業只適用於支持的媒體。 值：0xC0AA0402

備註

此值不一定反映媒體上可用的扇區總數，甚至不一定反映空白磁碟。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	imapi2.h

另請參閱

IDiscFormat2Data

IDiscFormat2Data：：get_FreeSectorsOnMedia