Platform SDK: DirectX

DDVIDEOPORTINFO

The DDVIDEOPORTINFO structure describes the transfer of video data to a surface. This structure is used with the IDirectDrawVideoPort::StartVideo method.

typedef struct _DDVIDEOPORTINFO{ 
    DWORD dwSize;            
    DWORD dwOriginX;         
    DWORD dwOriginY;         
    DWORD dwVPFlags;         
    RECT rCrop;              
    DWORD dwPrescaleWidth;   
    DWORD dwPrescaleHeight;  
    LPDDPIXELFORMAT lpddpfInputFormat;     
    LPDDPIXELFORMAT lpddpfVBIInputFormat;  
    LPDDPIXELFORMAT lpddpfVBIOutputFormat; 
    DWORD dwVBIHeight;        
    ULONG_PTR dwReserved1;    
    ULONG_PTR dwReserved2;    
} DDVIDEOPORTINFO,*LPDDVIDEOPORTINFO; 

Members

dwSize
Size of this structure, in bytes. This member must be initialized before the structure is used.
dwOriginX and dwOriginY
X- and y-coordinates for the origin of the video data in the surface.
dwVPFlags
The following video-port options:
DDVP_AUTOFLIP
Perform automatic flipping. For more information, see Autoflipping.
DDVP_CONVERT
Perform conversion, using the information in the lpddpfVBIOutputFormat member.
DDVP_CROP
Perform cropping, using the rectangle specified by the rCrop member.
DDVP_IGNOREVBIXCROP
The video port should ignore left and right cropping coordinates when cropping oversampled VBI data.
DDVP_INTERLEAVE
Interlaced fields should be interleaved in memory.
DDVP_MIRRORLEFTRIGHT
Mirror image data from left to right as it is written into the frame buffer.
DDVP_MIRRORUPDOWN
Mirror image data from top to bottom as it is written into the frame buffer.
DDVP_OVERRIDEBOBWEAVE
Override automatic display method chosen by the driver, using only the display method set by the caller when creating the overlay surface.
DDVP_PRESCALE
Perform prescaling or prezooming, based on the values in the dwPrescaleHeight and dwPrescaleWidth members.
DDVP_SKIPEVENFIELDS
Ignore input of even fields.
DDVP_SKIPODDFIELDS
Ignore input of odd fields.
DDVP_SYNCMASTER
The video port VREF should drive the graphics VREF, locking the refresh rate to the video port.
DDVP_VBICONVERT
The lpddpfVBIOutputFormat member contains data to be used to convert VBI data.
DDVP_VBINOSCALE
VBI data should not be scaled.
DDVP_VBINOINTERLEAVE
Interleaving can be disabled for data within the VBI.
rCrop
Cropping rectangle. This member is optional.
dwPrescaleWidth
Prescaling or zooming in the x-direction. This member is optional.
dwPrescaleHeight
Prescaling or zooming in the y-direction. This member is optional.
lpddpfInputFormat
DDPIXELFORMAT structure describing the pixel format to be written to the video port. This is often identical to the surface's pixel format, but can differ if the video port is to perform conversion.
lpddpfVBIInputFormat and lpddpfVBIOutputFormat
DDPIXELFORMAT structures describing the input and output pixel formats of the data within the vertical blanking interval.
dwVBIHeight
Amount of data within the vertical blanking interval, in scan lines.
dwReserved1 and dwReserved2
Reserved; set to 0.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dvp.h.