StartRangeSourcePrefetch

Documentbeheer, geleidelijk laden, prestaties

Beschrijving

Zet een achtergrondtaak in de wachtrij die herhaaldelijk de ontbrekende bytebereiken ontdekt en ophaalt die een pagina-, formulier- of indirect-object-afhankelijkheidsgraaf nodig heeft

Syntaxis

Delphi

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

Parameters

DataKind	`PDF_RANGE_DATA_PAGE`, `PDF_RANGE_DATA_FORM` of `PDF_RANGE_DATA_OBJECT`
Index	Een paginanummer beginnend bij 1, nul voor de formulierquery, of een nummer van een indirect object
Priority	`PDF_RANGE_PREFETCH_PRIORITY_LOW`, `NORMAL`, `HIGH` of `CRITICAL`
MaxBytes	Het leesbudget van de taak; nul kiest 64 MiB en een expliciete waarde moet ten minste één bronchunk omvatten
ReadAheadBytes	Extra bytes die na elk ontdekt afhankelijkheidsbereik worden ingepland vóór chunkuitlijning
MaxPasses	Het maximale aantal afhankelijkheidsontdekkingsrondes; nul kiest 128

Retourwaarde

Een positieve, stream-lokale taakhandle bij succes, of nul met LastErrorCode ingesteld op 401 wanneer het geselecteerde document niet range-backed is of de argumenten ongeldig zijn

Opmerkingen

Eén worker bedient elke bereikstream en kiest de hoogste prioriteit in de wachtrij, waarbij FIFO-volgorde binnen gelijke prioriteiten behouden blijft

De worker gebruikt een geïsoleerde parser boven de gedeelde byte-range-cache, zodat afhankelijkheidsontdekking geen veranderlijke lezertoestand deelt met voorgronddocumentbewerkingen

Het bytebudget omvat ongecachte lezingen die worden uitgevoerd bij het initialiseren en voortbewegen van de geïsoleerde afhankelijkheidsparser

Vooraf opgehaalde bytes blijven onderworpen aan het streamcachebudget en het least-recently-used-uitzetbeleid