StartRangeSourcePrefetch

Dokumenthåndtering, progressiv indlæsning, ydeevne

Beskrivelse

Sætter et baggrundsjob i kø, der gentagne gange opdager og henter de manglende byteintervaller, som en side-, formular- eller indirekte objekt-afhængighedsgraf kræver

Syntaks

Delphi

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

Parametre

DataKindPDF_RANGE_DATA_PAGE, PDF_RANGE_DATA_FORM eller PDF_RANGE_DATA_OBJECT
IndexEt 1-baseret sidetal, nul for formularforespørgslen eller et nummer på et indirekte objekt
PriorityPDF_RANGE_PREFETCH_PRIORITY_LOW, NORMAL, HIGH eller CRITICAL
MaxBytesJobbets læsebudget; nul vælger 64 MiB, og en eksplicit værdi skal rumme mindst én kilde-chunk
ReadAheadBytesEkstra bytes, der planlægges efter hvert opdagede afhængighedsinterval før chunk-justering
MaxPassesDet maksimale antal afhængighedsopdagelsesrunder; nul vælger 128

Returværdi

Et positivt stream-lokalt jobhandle ved succes, eller nul med LastErrorCode sat til 401, når det valgte dokument ikke er range-bageret, eller argumenterne er ugyldige

Bemærkninger

Én arbejder betjener hver områdestrøm og vælger den højst køede prioritet og bevarer FIFO-rækkefølgen inden for lige prioriteter

Arbejderen bruger en isoleret parser over den delte byte-range-cache, så afhængighedsopdagelse ikke deler foranderlig læsertilstand med forgrundens dokumentoperationer

Bytebudgettet inkluderer ikke-cachelagrede læsninger udført under initialisering og fremdrift af den isolerede afhængighedsparser

Forudhentede bytes forbliver underlagt strøm-cachebudgettet og politikken for udstødelse af mindst nyligt anvendte