THPDFRandomAccessSource.ReadAtCancellable Method
讀取 Offset 處的位元組,並在底層讀取前後檢查取消 token
宣告
function ReadAtCancellable(Offset: Int64; var Buffer; Count: Longint;
CancellationToken: THPDFCancellationToken): Longint; virtual;單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
Offset | 讀取起點的零基位元組偏移 |
Buffer | 接收位元組的無型別緩衝區 |
Count | 最多讀取的位元組數 |
CancellationToken | 輪詢取消狀態的 token;傳 nil 則不做取消檢查直接讀取 |
傳回值
讀取的位元組數,以 ReadAt 回報的值為準
使用說明
- 基底實作在 token 被觸發時,於
ReadAt前後引發取消例外 - 網路或封存後備輸入等慢速來源應覆寫此方法,在傳輸區塊之間輪詢 token
- 確定性重放會包裝此方法,讓錄製的執行重現相同的取消決策