iWriteEngine2 介面 (imapi2.h)
使用此介面將數據流寫入裝置。
開發新媒體類型或格式的支援時，應該使用此介面。 寫入媒體通常包含下列步驟：
- 藉由設定媒體的模式頁面來準備硬體。
- 查詢硬體以確認媒體夠大。
- 例如，藉由格式化媒體或設定 OPC 來初始化寫入。
- 執行實際的 WRITE 命令。
- 藉由停止格式設定或關閉工作階段或追蹤，以完成寫入。
大部分的用戶端應用程式都應該使用 IDiscFormat2Data 介面將映像寫入裝置。
若要建立此介面的實例，請呼叫 CoCreateInstance函式 。 Use__uuidof (类别标识符的 MsftWriteEngine2) ，以及介面標識碼的 __uuidof (IWriteEngine2) 。
繼承
IWriteEngine2 介面繼承自 IDispatch 介面。 IWriteEngine2 也有下列類型的成員：
方法
IWriteEngine2 介面具有這些方法。
| IWriteEngine2：：CancelWrite 取消進行中的寫入作業。 |
| IWriteEngine2：：get_BytesPerSector 擷取寫入期間每個扇區要使用的位元元組數目。 傳回的值表示先前使用 IWriteEngine2：:p ut_BytesPerSector 設定的值，而且不會針對媒體傳回目前每個扇區值的位元組。 |
| IWriteEngine2：：get_EndingSectorsPerSecond 擷取錄製裝置可以在寫入程序結束時寫入媒體的每秒估計扇區數目。 |
| IWriteEngine2：：get_Recorder 擷取要用於寫入作業的錄製裝置。 |
| IWriteEngine2：：get_StartingSectorsPerSecond 擷取錄製裝置可以在寫入程序開始時寫入媒體的每秒估計扇區數目。 |
| IWriteEngine2：：get_UseStreamingWrite12 擷取值，指出寫入作業是否使用 WRITE12 或 WRITE10 命令。 |
| IWriteEngine2：：get_WriteInProgress 擷取值，指出錄製器目前是否正在將數據寫入光碟。 |
| IWriteEngine2：:p ut_BytesPerSector 設定寫入期間每個扇區要使用的位元元組數目。 |
| IWriteEngine2：:p ut_EndingSectorsPerSecond 設定錄製裝置可以在寫入程序結束時寫入媒體的每秒估計扇區數目。 |
| IWriteEngine2：:p ut_Recorder 設定寫入作業的錄製裝置。 |
| IWriteEngine2：:p ut_StartingSectorsPerSecond 設定錄製裝置可以在寫入程式開始時寫入媒體的每秒估計扇區數目。 |
| IWriteEngine2：:p ut_UseStreamingWrite12 設定值，指出寫入作業是否使用 WRITE12 或 WRITE10 命令。 |
| IWriteEngine2：：WriteSection 將數據流寫入目前的錄製器。 |
備註
若要在腳本中建立 MsftWriteEngine2 物件，請使用 IMAPI2。呼叫 CreateObject 時，MsftWriteEngine2 做為程式識別符。
電源狀態轉換可以在 (期間進行，也就是使用者註銷或系統暫停) ，這會導致損毀程式中斷和可能的數據遺失。 如需程序設計考慮，請參閱 防止在待用期間註銷或暫停。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista、Windows XP SP2 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | imapi2.h |