THPDFRandomAccessSource.ReadAtCancellable 方法
在 Offset 处读取字节,并在底层读取前后检查取消令牌
声明
function ReadAtCancellable(Offset: Int64; var Buffer; Count: Longint;
CancellationToken: THPDFCancellationToken): Longint; virtual;
单元
HPDFDoc
参数
| 名称 | 用途 |
|---|---|
Offset | 开始读取的从零计字节偏移 |
Buffer | 接收字节的无类型缓冲区 |
Count | 最多读取的字节数 |
CancellationToken | 用于轮询取消的令牌;nil 表示读取时不做取消检查 |
返回值
读取的字节数,由 ReadAt 报告
使用说明
- 基类实现会在令牌已发信号时于
ReadAt前后抛出取消异常 - 网络或归档支持等慢速源应覆写此方法,在传输块之间轮询令牌
- 确定性重放会包装此方法,让录制的运行重现相同的取消决策