THPDFRandomAccessSource.ReadAtCancellable メソッド
基底の読み出しの前後でキャンセルトークンを観察しながら、Offset 位置からバイトを読み取ります
宣言
function ReadAtCancellable(Offset: Int64; var Buffer; Count: Longint;
CancellationToken: THPDFCancellationToken): Longint; virtual;
ユニット
HPDFDoc
パラメータ
| 名前 | 目的 |
|---|---|
Offset | 読み出し開始位置のゼロベースバイトオフセット |
Buffer | バイトを受け取る型なしバッファ |
Count | 読み出す最大バイト数 |
CancellationToken | キャンセルをポーリングするトークン。nil ならキャンセルチェックなしで読み出します |
戻り値
ReadAt が報告した読み出しバイト数
使用上の注意
- 基底実装は、トークンがシグナル状態のとき
ReadAtの前後でキャンセル例外を送出します - ネットワークやアーカイブバックエンドの入力のような低速ソースでは、転送チャンクの合間にトークンをポーリングするようオーバーライドします
- 決定的再生はこのメソッドをラップし、記録された実行が同じキャンセル判断を再現するようにします