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は成功時に返されますが、実装の結果として他の成功コードが返される場合があります。次のエラーコードは、通常、操作の失敗時に返されますが、考えられる唯一のエラー値を表すわけではありません。

このメソッドを呼び出す前に、 IWriteEngine2::p ut_Recorder メソッドを呼び出して記録デバイスを指定し、 IWriteEngine2::p ut_BytesPerSector メソッドを呼び出して、書き込み中に各セクターに使用するバイト数を指定する必要があります。

また、アプリケーションに対して既定値が適切でない場合は、次のメソッドを呼び出すことも検討してください。

このメソッドは同期的です。書き込み操作の進行状況を確認するには、 DWriteEngine2Events インターフェイスを実装する必要があります。スクリプトにイベントハンドラーを実装する方法を示す例については、「イベントを使用した進行状況の監視」を参照してください。


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