مرجع HotPDF

يُعرِّف فاكّ ترميز مخصَّصًا معدود المراجع تستخدمه خطوط أنابيب مرشِّحات التدفق المحمَّل

التصريح

IHPDFCustomStreamFilter = interface(IInterface)
  function GetFilterName: AnsiString;
  function GetMode: THPDFCustomStreamFilterMode;
  function GetInputSeekContract: THPDFCustomStreamSeekContract;
  function GetOutputSeekContract: THPDFCustomStreamSeekContract;
  function DecodePush(Input, Output: TStream;
    const Request: THPDFCustomStreamFilterRequest;
    out Diagnostic: AnsiString): Boolean;
  function OpenPullStream(Input: TStream;
    const Request: THPDFCustomStreamFilterRequest;
    out DecodedStream: TStream;
    out Diagnostic: AnsiString): Boolean;
end;

المعاملات

تُستعار Input للاستدعاء، وتُعد Output وجهة معزولة محدودة لوضع الدفع (push)، وتوفّر Request هوية المرحلة والميزانية المتبقية والإلغاء

تُصبح DecodedStream مملوكة لـ HotPDF بعد نتيجة سحب (pull) ناجحة، بينما ينبغي أن توضّح Diagnostic نتيجة سالبة

المعاملات

أعد True فقط بعد إنتاج نتيجة مرحلة كاملة وصالحة

المعاملات

تُستدعى فقط الطريقة التي يحدّدها Mode
لا تحرّر تدفق Input المُستعار أو تحتفظ به أو تُعِده
ينبغي أن تتحقق العمليات الطويلة من Request.CancellationToken بشكل تعاوني
تُعزَل الاستثناءات كـ dpsCustomFilterError أو dpsBudgetExceeded أو dpsCancelled
تُنفَّذ الاستدعاءات بشكل متزامن وخارج قفل السجل (registry)