DDHAL_UPDATEVPORTDATA

The DDHAL_UPDATEVPORTDATA structure contains the information required to start, stop, and change the video port. This structure passes the information to the DirectDraw HAL UpdateVideoPort callback function.

typedef struct _DDHAL_UPDATEVPORTDATA
{
LPDDRAWI_DIRECTDRAW_LCL      lpDD;
LPDDRAWI_DDVIDEOPORT_LCL     lpVideoPort;
LPDDRAWI_DDRAWSURFACE_INT    *lplpDDSurface;
LPDDRAWI_DDRAWSURFACE_INT    *lplpDDVBISurface;
LPDDVIDEOPORTINFO            lpVideoInfo;
DWORD                        dwFlags;
DWORD                        dwNumAutoflip;
DWORD                        dwNumVBIAutoflip;
HRESULT                      ddRVal;
LPDDHALVPORTCB_UPDATE        UpdateVideoPort;
} DDHAL_UPDATEVPORTDATA;

Members

  • lpDD
    Pointer to the DDRAWI_DIRECTDRAW_LCL structure that represents the DirectDraw object.

  • lpVideoPort
    Pointer to the DDRAWI_DDVIDEOPORT_LCL structure that represents this video port.

  • lplpDDSurface
    Pointer to an array of surface structures that represent regular video surfaces. This member points to an array of surface structures to accommodate autoflipping.

  • lplpDDVBISurface
    Pointer to an array of surface structures that represent VBI surfaces. This member points to an array of surface structures to accommodate autoflipping.

  • lpVideoInfo
    Pointer to a DDVIDEOPORTINFO structure that describes the transfer of video data to a surface.

  • dwFlags
    Control flags for the video port. One of the following:

    Flag Usage
    DDRAWI_VPORTSTART Indicates that the video port is being started.
    DDRAWI_VPORTSTOP Indicates that the video port is being stopped.
    DDRAWI_VPORTUPDATE Indicates that the video port is being updated.
  • dwNumAutoflip
    Contains the number of surfaces in the list if autoflipping is requested. If this value is greater than 1, lplpDDSurface and lplpDDVBISurface are arrays.

  • dwNumVBIAutoflip
    Contains the number of surfaces in the list if autoflipping is requested. This pertains to devices that can pump the VBI data to a different surface. If this value is greater than 1, lplpDDSurface and lplpDDVIBSurface are arrays.

  • ddRVal
    Passes the DirectDraw return values.

  • UpdateVideoPort
    This member is used by DirectDraw and should not be filled in by the driver.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.