IHPDFCustomStreamFilter

Yüklü stream filter pipeline'larında kullanılan, referans sayan özel bir çözücü tanımlar

Bildirim

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;

Parametreler

Input callback için ödünç verilir, Output push modu için izole ve sınırlı bir hedeftir, Request ise stage kimliğini, kalan bütçeyi ve iptal bilgisini sağlar

DecodedStream başarılı bir pull sonucunun ardından HotPDF'e ait olur, Diagnostic ise false sonuç durumunda nedeni açıklamalıdır

Dönüş değeri

True değerini yalnızca eksiksiz ve geçerli bir stage sonucu ürettikten sonra döndürün

Kullanım notları

• Yalnızca Mode ile seçilen metod çağrılır
• Ödünç alınan Input stream'ini serbest bırakmayın, saklamayın veya döndürmeyin
• Uzun süren işlemler Request.CancellationToken değerini cooperative biçimde kontrol etmelidir
• İstisnalar dpsCustomFilterError, dpsBudgetExceeded veya dpsCancelled olarak izole edilir
• Callback'ler senkron olarak ve registry kilidi dışında yürütülür

İlgili API'ler

• Özel Stream Filter Registry
• THotPDF.RegisterCustomStreamFilter
• THPDFCustomStreamFilterRequest