[ TDx_DrawVideoPort ]
[ next: GetColorControls() ]
[ prev: Flip() ]
public:
virtual bool __fastcall GetBandwidthInfo( TDDPixelFormat* pFormat, dword pWidth, dword pHeight, dword pFlags, TDDVideoPortBandwidth* pBandwidth );
If you would like to submit additions or improvements to this page, click: admin@bcb-tools.com.
DESCRIPTION
Top
Parameters
See Also
The
TDx_DrawVideoPort::GetBandwidthInfo
method
will
retrieve
the
overlay
zoom
factors
and
device
limitations
for
a
video
port
outputting
the
specified
pixel
format.
This
method
is
usually
called
twice.
Once
with
DDVPB_TYPE
set
to
determine
whether
the
bandwidth
information
is
provided
in
terms
of
the
destination
or
source
overlay
size
and
again
with
either
of
the
other
flags
set
as
indicated
by
the
previous
call
to
retrieve
the
required
information.
If
the
method
call
fails,
the
OnError
event
will
be
triggered
with
one
of
the
following
values:
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
PARAMETERS
Top
See Also
Format
The Format parameter references a TDDPixelFormat component defining the output pixel format for which bandwidth information is being requested.
Width
The Width parameter defines the horizontal dimension of an overlay or the video data width.
Interpretation of this value depends on which flags are set in the Flags parameter of this method.
Height
The Height parameter defines the vertical dimension of an overlay or the video data height.
Interpretation of this value depends on which flags are set in the Flags parameter of this method.
Flags
The Flags parameter defines flags indicating how the Width and Height parameters of this method are to be interpreted. The described effect applies when the flag is set.
DDVPB_OVERLAY
The Width and Height parameters of this method define the source overlay surface's size.
This flag should be set when the video port is dependent on the source overlay size.
DDVPB_TYPE
Retrieve the device's dependency type in the TDDVideoPortBandwidth::Caps referenced by the Bandwidth parameter of this method.
This flag should be used on the first call to this method.
The Width and Height parameters of this method will be empty.
DDVPB_VIDEOPORT
The Width and Height parameters define the prescale size of the video data written to the frame buffer by the video port.
This flag should be set when the video port is dependent on the overlay zoom factor.
Bandwidth
The Bandwidth parameter references a TDDVideoPortBandwidth component for holding the retrieved bandwidth and device dependency information if this method returns successfully.
SEE ALSO
Top
Parameters
Component:
TDX_DRAWVIDEOPORT::GETBANDWIDTHINFO()
