ILayoutStorage

ILayoutStorage インターフェイスを使用すると、アプリケーションは複合ファイルのレイアウトを最適化し、低速な回線上でも効率的にダウンロードできるようにできます。

LayoutScript メソッドは、複合ファイル内のストレージ、ストリーム、コントロールを、ダウンロード時にアクセスされる順序に合わせて並べ替えるための明示的な指示を提供します。

この関数は、標準の戻り値 E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、E_FAIL に加えて、次の値をサポートします。

明示的なレイアウト指示を提供するために、アプリケーションは ILayoutStorage::LayoutScript を呼び出し、 StorageLayout 構造体の配列を渡します。各構造体は 1 つのストレージまたはストリームのデータブロックを定義し、そのブロックを ILockBytes バイト配列内のどこに書き込むかを指定します。

アプリケーションは、特定の複合ファイルの構造に応じて、スクリプトによるレイアウトと監視を組み合わせることができます。

複合ファイル全体の最適なデータレイアウトのパターンが決定されると、アプリケーションは ILayoutStorage::ReLayoutDocfile を呼び出して、データセクターがアクセスされた順序に合わせて複合ファイルを再構築します。

BeginMonitor メソッドは、読み込み操作の開始時に監視を開始するために使用します。操作が完了したら、アプリケーションは ILayoutStorage::EndMonitor を呼び出す必要があります。

このメソッドは、標準の戻り値 E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、E_FAIL に加えて、次の値をサポートします。

通常、アプリケーションは実際の読み込みが始まる前に BeginMonitor を呼び出します。このメソッドが呼び出されると、複合ファイルの実装は、ファイルのストレージやストリームに対して実行されるすべての操作を、目的のアクセスパターンの一部と見なします。その結果として、 ILayoutStorage::LayoutScript を呼び出して明示的に作成したものと同様のレイアウトスクリプトが生成されます。

アプリケーションは通常、埋め込みオブジェクトのアクセスパターンを取得するために監視を使用します。また、監視により、既存のアプリケーションを起動してそのアクセスパターンを監視する汎用的なレイアウトツールも実現できます。

ILayoutStorage::EndMonitor を呼び出すと、監視が終了します。 BeginMonitor と EndMonitor は複数回呼び出すことができます。また、監視は ILayoutStorage::LayoutScript の呼び出しと組み合わせることもできます。

EndMonitor メソッドは、複合ファイルの監視を終了します。この呼び出しの前に ILayoutStorage::BeginMonitor を呼び出しておく必要があります。

この関数は、標準の戻り値 E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、E_FAIL に加えて、CloseHandle のすべての戻り値をサポートします。

EndMonitor の呼び出しの後には、通常 ILayoutStorage::RelayoutDocfile の呼び出しが続きます。これは、監視によって検出されたアクセスパターンを使用して複合ファイルを再構築します。

ReLayoutDocfile メソッドは、監視によって取得した、または明示的なレイアウトスクリプトによって提供されたレイアウトスクリプトを使用して複合ファイルを書き換え、新しい複合ファイルを作成します。

この関数は、標準の戻り値 E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG、E_FAIL に加えて、次の値をサポートします。

実装されていません。呼び出された場合は STG_E_UNIMPLEMENTEDFUNCTION を返します。

このメソッドは次の値を返します。

実装されている場合は、呼び出し元が指定したバイト配列オブジェクト内の複合ファイルを書き換えます。成功した場合は S_OK を返し、失敗した場合は STG_E_* エラーコードのいずれかを返します。