IWriteEngine2 インターフェイス (imapi2.h)

[アーティクル]
02/28/2024

このインターフェイスを使用して、データストリームをデバイスに書き込みます。

このインターフェイスは、新しいメディアの種類または形式のサポートを開発しているユーザーが使用する必要があります。通常、メディアへの書き込みには、次の手順が含まれます。

メディアのモードページを設定してハードウェアを準備する。
ハードウェアに対してクエリを実行して、メディアの大きさが十分であることを確認します。
たとえば、メディアの書式設定や OPC の設定による書き込みの初期化。
実際の WRITE コマンドの実行。
書式設定を停止するか、セッションまたはトラックを閉じて書き込みを完了します。

新しいメディアの種類のサポートを開発する場合は、手順 1、2、3、5 を実装し、このインターフェイスを使用して手順 4 を実行できます。すべての IDiscFormat2* インターフェイスは、このインターフェイスを使用して書き込み操作を実行します。

ほとんどのクライアントアプリケーションでは、 IDiscFormat2Data インターフェイスを使用してデバイスにイメージを書き込む必要があります。

このインターフェイスのインスタンスを作成するには、 CoCreateInstance 関数を呼び出します。クラス識別子にUse__uuidof(MsftWriteEngine2)、インターフェイス識別子に__uuidof(IWriteEngine2) を指定します。

継承

IWriteEngine2 インターフェイスは、IDispatch インターフェイスから継承されます。 IWriteEngine2 には、次の種類のメンバーもあります。

メソッド

IWriteEngine2 インターフェイスには、これらのメソッドがあります。


IWriteEngine2::CancelWrite 進行中の書き込み操作を取り消します。
IWriteEngine2::get_BytesPerSector 書き込み中にセクターごとに使用するバイト数を取得します。戻り値は、以前に IWriteEngine2::p ut_BytesPerSector で設定された値を示し、メディアのセクター値ごとに現在のバイト数を返しません。
IWriteEngine2::get_EndingSectorsPerSecond 記録デバイスが書き込みプロセスの最後にメディアに書き込むことができる 1 秒あたりのセクターの推定数を取得します。
IWriteEngine2::get_Recorder 書き込み操作で使用する記録デバイスを取得します。
IWriteEngine2::get_StartingSectorsPerSecond 記録デバイスが書き込みプロセスの開始時にメディアに書き込むことができる 1 秒あたりのセクターの推定数を取得します。
IWriteEngine2::get_UseStreamingWrite12 書き込み操作で WRITE12 または WRITE10 コマンドを使用するかどうかを示す値を取得します。
IWriteEngine2::get_WriteInProgress レコーダーが現在ディスクにデータを書き込んでいるかどうかを示す値を取得します。
IWriteEngine2::p ut_BytesPerSector 書き込み中にセクターごとに使用するバイト数を設定します。
IWriteEngine2::p ut_EndingSectorsPerSecond 記録デバイスが書き込みプロセスの最後にメディアに書き込むことができる 1 秒あたりのセクターの推定数を設定します。
IWriteEngine2::p ut_Recorder 書き込み操作の記録デバイスを設定します。
IWriteEngine2::p ut_StartingSectorsPerSecond 記録デバイスが書き込みプロセスの開始時にメディアに書き込むことができる 1 秒あたりのセクターの推定数を設定します。
IWriteEngine2::p ut_UseStreamingWrite12 書き込み操作で WRITE12 または WRITE10 コマンドを使用するかどうかを示す値を設定します。
IWriteEngine2::WriteSection データストリームを現在のレコーダーに書き込みます。

注釈

スクリプトで MsftWriteEngine2 オブジェクトを作成するには、IMAPI2 を使用します。 CreateObject を呼び出すときのプログラム識別子としての MsftWriteEngine2。

書き込み処理の中断とデータ損失の可能性につながる書き込み操作 (ユーザーのログオフやシステムの中断など) 中に電源状態の切り替えが行われる可能性があります。プログラミングに関する考慮事項については、「バーン中のログオフの防止」または「中断」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	imapi2.h