รีเคิร์ด THPDFMappedFileStatistics

รายงาน telemetry ด้านการตั้งค่า, geometry, mapping, cache และการโอนถ่าย ที่ memory-mapped file source เก็บไว้ระหว่างการโหลด

การประกาศ

THPDFMappedFileStatistics= record
  FileSize: Int64;
  ConfiguredWindowSize: Int64;
  ConfiguredCacheWindowCount: Integer;
  WindowSize: Int64;
  CacheWindowCount: Integer;
  MappedByteLimit: Int64;
  CurrentMappedBytes: Int64;
  PeakMappedBytes: Int64;
  GeometryChangeCount: Int64;
  SequentialReadCalls: Int64;
  RandomReadCalls: Int64;
  AdaptiveGeometry: Boolean;
  SequentialGeometryActive: Boolean;
  RandomGeometryActive: Boolean;
  ReadCalls: Int64;
  BytesRead: Int64;
  MapCount: Int64;
  CacheHits: Int64;
  FallbackReadCalls: Int64;
  FallbackBytes: Int64;
  DirectTransferCalls: Int64;
  DirectTransferBytes: Int64;
end;

ยูนิต

HPDFObjs

ฟิลด์

ฟิลด์	วัตถุประสงค์
`FileSize`	ขนาดของไฟล์ซอร์สที่ map ไว้ เป็นไบต์
`ConfiguredWindowSize`	ขนาด window ตามที่ตั้งผ่าน `LocalFileMappingWindowSize`
`ConfiguredCacheWindowCount`	จำนวน window ที่ให้พำนักอยู่ตามที่ตั้งผ่าน `LocalFileMappingCacheWindows`
`WindowSize`	ขนาด window ที่มีผลจริงกับซอร์สนี้
`CacheWindowCount`	จำนวน window ที่ window cache ถืออยู่ตอนนี้
`MappedByteLimit`	เพดานของจำนวนไบต์ที่ซอร์สเก็บ map ไว้ได้พร้อมกัน
`CurrentMappedBytes`	จำนวนไบต์ที่ map อยู่ ณ ปัจจุบัน
`PeakMappedBytes`	ระดับสูงสุดของไบต์ที่ map ไว้ตลอดการโหลด
`GeometryChangeCount`	จำนวนครั้งที่ adaptive geometry สลับ layout ของ window
`SequentialReadCalls`	คำขออ่านที่จัดอยู่ในกลุ่ม sequential
`RandomReadCalls`	คำขออ่านที่จัดอยู่ในกลุ่ม random access
`AdaptiveGeometry`	True เมื่อซอร์สนี้เปิดการเลือก geometry แบบ adaptive ไว้
`SequentialGeometryActive`	True ขณะที่ geometry แบบ sequential ทำงานอยู่
`RandomGeometryActive`	True ขณะที่ geometry แบบ random access ทำงานอยู่
`ReadCalls`	จำนวนคำขออ่านทั้งหมดที่จัดการผ่าน mapped source
`BytesRead`	จำนวนไบต์ทั้งหมดที่การอ่านเหล่านั้นส่งมอบ
`MapCount`	จำนวนครั้งที่ file view ถูก map เข้า window
`CacheHits`	การอ่านที่ตอบจาก window ที่พำนักอยู่แล้วได้เลย
`FallbackReadCalls`	การอ่านที่ต้อง fallback ไปอ่านไฟล์ธรรมดานอก window cache
`FallbackBytes`	จำนวนไบต์ที่ส่งมอบจากการอ่านแบบ fallback
`DirectTransferCalls`	การโอนจากสตรีมสู่สตรีมโดยตรงที่ข้าม window cache
`DirectTransferBytes`	จำนวนไบต์ที่ย้ายโดยการโอนแบบตรง

หมายเหตุการใช้งาน

อ่านรีเคิร์ดด้วย THotPDF.GetLastMappedFileStatistics ซึ่งคืน True ก็ต่อเมื่อการโหลดล่าสุดใช้ memory mapping จริง
ปรับ geometry ด้วย LocalFileMappingWindowSize, LocalFileMappingCacheWindows และ LocalFileMappingAdaptiveGeometry ก่อนโหลด
SequentialGeometryActive กับ RandomGeometryActive เป็น snapshot ที่เปิดพร้อมกันไม่ได้ บอกโหมดปัจจุบันขณะนั้น

รีเคิร์ด THPDFMappedFileStatistics

การประกาศ

ยูนิต

ฟิลด์

หมายเหตุการใช้งาน

API ที่เกี่ยวข้อง