StartRangeSourcePrefetch

ドキュメント管理、プログレッシブローディング、パフォーマンス

説明

ページ、フォーム、間接オブジェクトの依存グラフが必要とする欠落バイト範囲を繰り返し発見して取得するバックグラウンドジョブをキューに入れます

構文

Delphi

Function TPDFlib.StartRangeSourcePrefetch(DataKind, Index, Priority: Integer;
  MaxBytes: Int64= 0; ReadAheadBytes: LongInt= 0;
  MaxPasses: Integer= 0): Integer;

パラメータ

DataKind	`PDF_RANGE_DATA_PAGE`、`PDF_RANGE_DATA_FORM`、または `PDF_RANGE_DATA_OBJECT`
Index	1 ベースのページ番号、フォーム照会なら 0、または間接オブジェクト番号
Priority	`PDF_RANGE_PREFETCH_PRIORITY_LOW`、`NORMAL`、`HIGH`、`CRITICAL` のいずれか
MaxBytes	ジョブの読み取り予算。0 で 64 MiB が選択され、明示的な値は少なくとも 1 つのソースチャンクを保持する必要があります
ReadAheadBytes	発見された各依存範囲の後に、チャンク境界調整の前に予定される追加バイト
MaxPasses	依存発見ラウンドの最大数。0 で 128 が選択されます

戻り値

成功時は正のストリームローカルジョブハンドルを返します。選択されたドキュメントが範囲バックエンドでないか引数が不正な場合は、LastErrorCode を 401 に設定して 0 を返します

備考

1つのワーカーが各レンジストリームを処理し、キューにある最も高い優先度を選びます。同じ優先度内ではFIFO順が保たれます

ワーカーは共有バイトレンジキャッシュ上の分離されたパーサーを使うため、依存関係の検出がフォアグラウンドのドキュメント操作と可変リーダー状態を共有しません

バイト予算には、分離された依存パーサーの初期化と前進の間に行われる未キャッシュ読み込みも含まれます

プリフェッチされたバイトは、ストリームキャッシュの予算とleast-recently-used退避ポリシーの対象のままです