LoadFromMappedFile
Dokumenthåndtering, ydeevne, filinput
Beskrivelse
Indlæser og vælger en lokal PDF gennem en afgrænset, skrivebeskyttet afbildet visning, så store udsatte objekt- og streamlæsninger kan genbruge operativsystemets fil sider uden at holde den komplette kilde i hukommelsen
Syntaks
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Parametre
| FileName | Stien til den lokale PDF |
|---|---|
| Password | Adgangskoden, der bruges til at åbne PDF'en, eller en tom streng for et ukrypteret dokument |
| WindowSize | Den ønskede størrelse af den afbildede visning i bytes; nul vælger 64 MiB, værdier under operativsystemets allokeringgranularitet hæves til den granularitet, og værdier over 1 GiB begrænses |
| Options | Nul tillader en fallback til skrivebeskyttet filstream, mens PDF_MAPPED_FILE_REQUIRE_MAPPING fejler, medmindre en afbildet visning er aktiv |
Returværdier
| 0 | Argumenterne var ugyldige, filen kunne ikke åbnes, påkrævet mapping var utilgængelig, eller PDF'en kunne ikke indlæses; undersøg LastErrorCode |
|---|---|
| 1 | Dokumentet blev indlæst og valgt |
Bemærkninger
Windows-builds bevarer ét skrivebeskyttet view og genafbilder det efter behov ved allokationsgranularitetsgrænser; andre platforme og afbildningsfejl bruger den samme absolut-læse-kontrakt over en almindelig skrivebeskyttet filstrøm, medmindre afbildning kræves
Standard 64 MiB-viewet afgrænser adresserumsbrug uafhængigt af kildens størrelse og egner sig til sparsom adgang til store lokale filer; et mindre view kan reducere resident adresseplads til prisen af flere genafbildninger
Absolutte objektudsnits-læsninger kopierer direkte fra det aktuelle view til parser-ejet lager uden at ændre den positionelle strøm-cursor; dette er ikke et vedvarende zero-copy pointer-API, fordi genafbildning ugyldiggør view-adresser
Kilden forbliver åben, indtil det indlæste dokument fjernes, og gemning eller udskudt udtrækning kan fortsætte med at læse den
Hvis OnPassword er tildelt, modtager hvert afvist adgangskodeforsøg en frisk afbildet strøm og parsertilstand
Brug GetMappedFileInfo til at bekræfte, om afbildning er aktiv, og se aktuelle view- og læsestatistikker