IAMLine21Decoder::SetRedrawAlways method (il21dec.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The SetRedrawAlways method specifies whether the Line 21 Decoder filter redraws the entire output bitmap for each sample.

Syntax

HRESULT SetRedrawAlways(
  BOOL bOption
);

Parameters

bOption

Specifies one of the following values.

Value Description
TRUE The filter always redraws the entire bitmap.
FALSE The filter does not always redraw the entire bitmap. (Default)

Return value

Returns S_OK if successful, or an error code otherwise.

Remarks

Generally, applications should not call this method. The downstream mixer or renderer filter should call this method with the value TRUE if it writes into the buffers that it receives from the Line 21 Decoder filter. Redrawing degrades performance and increases CPU load, because it negates any potential optimizations.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header il21dec.h
Library Strmiids.lib

See also

Error and Success Codes

IAMLine21Decoder Interface

IAMLine21Decoder::GetRedrawAlways