Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
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
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.
The Bandwidth parameter references a TDDVideoPortBandwidth component for holding the retrieved bandwidth and device dependency information if this method returns successfully.
- See Also
- Top
TDx_Draw_Library v2.00 Component Reference
|
|
|
[ TDx_DrawVideoPort::GetBandwidthInfo() ] [ next: GetColorControls() ] [ prev: Flip() ] public:
virtual bool __fastcall GetBandwidthInfo( TDDPixelFormat* pFormat, dword pWidth, dword pHeight, dword pFlags, TDDVideoPortBandwidth* pBandwidth );
TDX_DRAWVIDEOPORT::GETBANDWIDTHINFO()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|