IWriteEngine2::WriteSection 方法 (imapi2.h)

將資料流程寫入目前的錄製器。

語法

HRESULT WriteSection(
  [in] IStream *data,
  [in] LONG    startingBlockAddress,
  [in] LONG    numberOfBlocks
);

參數

[in] data

要寫入錄製器之資料流程的 IStream 介面。

[in] startingBlockAddress

啟動寫入作業的 LBA) 邏輯區塊位址 (。 支援負值。

[in] numberOfBlocks

要寫入之資料流程中的區塊數目。

傳回值

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

傳回碼 描述
E_POINTER
指標無效。

值:0x80004003

E_OUTOFMEMORY
無法配置所需的記憶體。

值:0x8007000E

E_INVALIDARG
一或多個引數無效。

值:0x80070057

E_IMAPI_REQUEST_CANCELLED
已取消要求。

值:0xC0AA0002

備註

呼叫此方法之前,您必須呼叫 IWriteEngine2::p ut_Recorder 方法,以指定錄製裝置和 IWriteEngine2::p ut_BytesPerSector 方法,以指定寫入期間每個磁區使用的位元組數目。

如果預設值不適合您的應用程式,您也應該考慮呼叫下列方法:

這個方法是同步方法。 若要判斷寫入作業的進度,您必須實作 DWriteEngine2Events 介面。 如需示範如何在腳本中實作事件處理常式的範例,請參閱 監視進度與事件

需求

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

另請參閱

DWriteEngine2Events

IWriteEngine2

IWriteEngine2::CancelWrite

IWriteEngine2::get_WriteInProgress

IWriteEngine2EventArgs::get_SectorCount

IWriteEngine2EventArgs::get_StartLba