dvp.h

Go to the documentation of this file.

/*==========================================================================;
 *
 *  Copyright (C) 1996-1997 Microsoft Corporation.  All Rights Reserved.
 *
 *  File:   dvp.h
 *  Content:    DirectDrawVideoPort include file
 *
 ***************************************************************************/
 
#ifndef __DVP_INCLUDED__
#define __DVP_INCLUDED__
#if defined( _WIN32 )  && !defined( _NO_COM )
#define COM_NO_WINDOWS_H
#include <objbase.h>
#else
#define IUnknown        void
#undef  CO_E_NOTINITIALIZED
#define CO_E_NOTINITIALIZED 0x800401F0L
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
/*
 * GUIDS used by DirectDrawVideoPort objects
 */
DEFINE_GUID( IID_IDDVideoPortContainer,     0x6C142760,0xA733,0x11CE,0xA5,0x21,0x00,0x20,0xAF,0x0B,0xE5,0x60 );
DEFINE_GUID( IID_IDirectDrawVideoPort,      0xB36D93E0,0x2B43,0x11CF,0xA2,0xDE,0x00,0xAA,0x00,0xB9,0x33,0x56 );
 
DEFINE_GUID( DDVPTYPE_E_HREFH_VREFH, 0x54F39980L,0xDA60,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_E_HREFH_VREFL, 0x92783220L,0xDA60,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_E_HREFL_VREFH, 0xA07A02E0L,0xDA60,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_E_HREFL_VREFL, 0xE09C77E0L,0xDA60,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_CCIR656,       0xFCA326A0L,0xDA60,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_BROOKTREE,     0x1352A560L,0xDA61,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
DEFINE_GUID( DDVPTYPE_PHILIPS,       0x332CF160L,0xDA61,0x11CF,0x9B,0x06,0x00,0xA0,0xC9,0x03,0xA3,0xB8);
 
/*
 * GUIDS used to describe connections
 */
 
 
/*============================================================================
 *
 * DirectDraw Structures
 *
 * Various structures used to invoke DirectDraw.
 *
 *==========================================================================*/
 
struct IDirectDraw;
struct IDirectDrawSurface;
struct IDirectDrawPalette;
struct IDirectDrawClipper;
 
typedef struct IDDVideoPortContainer        FAR *LPDDVIDEOPORTCONTAINER;
typedef struct IDirectDrawVideoPort     FAR *LPDIRECTDRAWVIDEOPORT;
 
typedef struct _DDVIDEOPORTCONNECT  FAR *LPDDVIDEOPORTCONNECT;
typedef struct _DDVIDEOPORTCAPS     FAR *LPDDVIDEOPORTCAPS;
typedef struct _DDVIDEOPORTDESC     FAR *LPDDVIDEOPORTDESC;
typedef struct _DDVIDEOPORTINFO     FAR *LPDDVIDEOPORTINFO;
typedef struct _DDVIDEOPORTBANDWIDTH    FAR *LPDDVIDEOPORTBANDWIDTH;
typedef struct _DDVIDEOPORTSTATUS   FAR *LPDDVIDEOPORTSTATUS;
 
typedef struct IDDVideoPortContainerVtbl DDVIDEOPORTCONTAINERCALLBACKS;
typedef struct IDirectDrawVideoPortVtbl  DIRECTDRAWVIDEOPORTCALLBACKS;
 
 
/*
 * API's
 */
typedef HRESULT (FAR PASCAL * LPDDENUMVIDEOCALLBACK)(LPDDVIDEOPORTCAPS, LPVOID);
 
 
/*
 * INTERACES FOLLOW:
 *  IDirectDrawVideoPort
 *  IVideoPort
 */
 
/*
 * IDirectDrawVideoPortContainer
 */
#undef INTERFACE
#define INTERFACE IDDVideoPortContainer
DECLARE_INTERFACE_( IDDVideoPortContainer, IUnknown )
{
    /*** IUnknown methods ***/
    STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
    STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
    STDMETHOD_(ULONG,Release) (THIS) PURE;
    /*** IDirectDrawVideoPort methods ***/
    STDMETHOD(CreateVideoPort)(THIS_ DWORD, LPDDVIDEOPORTDESC, LPDIRECTDRAWVIDEOPORT FAR *, IUnknown FAR *) PURE;
    STDMETHOD(EnumVideoPorts)(THIS_ DWORD, LPDDVIDEOPORTCAPS, LPVOID,LPDDENUMVIDEOCALLBACK ) PURE;
    STDMETHOD(GetVideoPortConnectInfo)(THIS_ DWORD, LPDWORD, LPDDVIDEOPORTCONNECT ) PURE;
    STDMETHOD(QueryVideoPortStatus)(THIS_ DWORD, LPDDVIDEOPORTSTATUS ) PURE;
};
 
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IVideoPortContainer_QueryInterface(p, a, b)         (p)->lpVtbl->QueryInterface(p, a, b)
#define IVideoPortContainer_AddRef(p)                       (p)->lpVtbl->AddRef(p)
#define IVideoPortContainer_Release(p)                      (p)->lpVtbl->Release(p)
#define IVideoPortContainer_CreateVideoPort(p, a, b, c, d)  (p)->lpVtbl->CreateVideoPort(p, a, b, c, d)
#define IVideoPortContainer_EnumVideoPorts(p, a, b, c, d)   (p)->lpVtbl->EnumVideoPorts(p, a, b, c, d)
#define IVideoPortContainer_GetVideoPortConnectInfo(p, a, b, c) (p)->lpVtbl->GetVideoPortConnectInfo(p, a, b, c)
#define IVideoPortContainer_QueryVideoPortStatus(p, a, b)   (p)->lpVtbl->QueryVideoPortStatus(p, a, b)
#else
#define IVideoPortContainer_QueryInterface(p, a, b)         (p)->QueryInterface(a, b)
#define IVideoPortContainer_AddRef(p)                       (p)->AddRef()
#define IVideoPortContainer_Release(p)                      (p)->Release()
#define IVideoPortContainer_CreateVideoPort(p, a, b, c, d)  (p)->CreateVideoPort(a, b, c, d)
#define IVideoPortContainer_EnumVideoPorts(p, a, b, c, d)   (p)->EnumVideoPorts(a, b, c, d)
#define IVideoPortContainer_GetVideoPortConnectInfo(p, a, b, c) (p)->GetVideoPortConnectInfo(a, b, c)
#define IVideoPortContainer_QueryVideoPortStatus(p, a, b)   (p)->QueryVideoPortStatus(a, b)
#endif
 
 
 
/*
 * IDirectDrawVideoPort
 */
#undef INTERFACE
#define INTERFACE IDirectDrawVideoPort
DECLARE_INTERFACE_( IDirectDrawVideoPort, IUnknown )
{
    /*** IUnknown methods ***/
    STDMETHOD(QueryInterface) (THIS_ REFIID riid, LPVOID FAR * ppvObj) PURE;
    STDMETHOD_(ULONG,AddRef) (THIS)  PURE;
    STDMETHOD_(ULONG,Release) (THIS) PURE;
    /*** IVideoPort methods ***/
    STDMETHOD(Flip)(THIS_ LPDIRECTDRAWSURFACE, DWORD) PURE;
    STDMETHOD(GetBandwidthInfo)(THIS_ LPDDPIXELFORMAT, DWORD, DWORD, DWORD, LPDDVIDEOPORTBANDWIDTH) PURE;
    STDMETHOD(GetColorControls)(THIS_ LPDDCOLORCONTROL) PURE;
    STDMETHOD(GetInputFormats)(THIS_ LPDWORD, LPDDPIXELFORMAT, DWORD) PURE;
    STDMETHOD(GetOutputFormats)(THIS_ LPDDPIXELFORMAT, LPDWORD, LPDDPIXELFORMAT, DWORD) PURE;
    STDMETHOD(GetFieldPolarity)(THIS_ LPBOOL) PURE;
    STDMETHOD(GetVideoLine)(THIS_ LPDWORD) PURE;
    STDMETHOD(GetVideoSignalStatus)(THIS_ LPDWORD) PURE;
    STDMETHOD(SetColorControls)(THIS_ LPDDCOLORCONTROL) PURE;
    STDMETHOD(SetTargetSurface)(THIS_ LPDIRECTDRAWSURFACE, DWORD) PURE;
    STDMETHOD(StartVideo)(THIS_ LPDDVIDEOPORTINFO) PURE;
    STDMETHOD(StopVideo)(THIS) PURE;
    STDMETHOD(UpdateVideo)(THIS_ LPDDVIDEOPORTINFO) PURE;
    STDMETHOD(WaitForSync)(THIS_ DWORD, DWORD, DWORD) PURE;
};
 
#if !defined(__cplusplus) || defined(CINTERFACE)
#define IVideoPort_QueryInterface(p,a,b)        (p)->lpVtbl->QueryInterface(p,a,b)
#define IVideoPort_AddRef(p)                    (p)->lpVtbl->AddRef(p)
#define IVideoPort_Release(p)                   (p)->lpVtbl->Release(p)
#define IVideoPort_SetTargetSurface(p,a,b)  (p)->lpVtbl->SetTargetSurface(p,a,b)
#define IVideoPort_Flip(p,a,b)          (p)->lpVtbl->Flip(p,a,b)
#define IVideoPort_GetBandwidthInfo(p,a,b,c,d,e) (p)->lpVtbl->GetBandwidthInfo(p,a,b,c,d,e)
#define IVideoPort_GetColorControls(p,a)    (p)->lpVtbl->GetColorControls(p,a)
#define IVideoPort_GetInputFormats(p,a,b,c) (p)->lpVtbl->GetInputFormats(p,a,b,c)
#define IVideoPort_GetOutputFormats(p,a,b,c,d)  (p)->lpVtbl->GetOutputFormats(p,a,b,c,d)
#define IVideoPort_GetFieldPolarity(p,a)    (p)->lpVtbl->GetFieldPolarity(p,a)
#define IVideoPort_GetVideoLine(p,a)        (p)->lpVtbl->GetVideoLine(p,a)
#define IVideoPort_GetVideoSignalStatus(p,a)    (p)->lpVtbl->GetVideoSignalStatus(p,a)
#define IVideoPort_SetColorControls(p,a)    (p)->lpVtbl->SetColorControls(p,a)
#define IVideoPort_StartVideo(p,a)      (p)->lpVtbl->StartVideo(p,a)
#define IVideoPort_StopVideo(p)         (p)->lpVtbl->StopVideo(p)
#define IVideoPort_UpdateVideo(p,a)     (p)->lpVtbl->UpdateVideo(p,a)
#define IVideoPort_WaitForSync(p,a,b,c)     (p)->lpVtbl->WaitForSync(p,a,b,c)
#else
#define IVideoPort_QueryInterface(p,a,b)        (p)->QueryInterface(a,b)
#define IVideoPort_AddRef(p)                    (p)->AddRef()
#define IVideoPort_Release(p)                   (p)->Release()
#define IVideoPort_SetTargetSurface(p,a,b)  (p)->SetTargetSurface(a,b)
#define IVideoPort_Flip(p,a,b)          (p)->Flip(a,b)
#define IVideoPort_GetBandwidthInfo(p,a,b,c,d,e) (p)->GetBandwidthInfo(a,b,c,d,e)
#define IVideoPort_GetColorControls(p,a)    (p)->GetColorControls(a)
#define IVideoPort_GetInputFormats(p,a,b,c) (p)->GetInputFormats(a,b,c)
#define IVideoPort_GetOutputFormats(p,a,b,c,d)  (p)->GetOutputFormats(a,b,c,d)
#define IVideoPort_GetFieldPolarity(p,a)    (p)->GetFieldPolarity(a)
#define IVideoPort_GetVideoLine(p,a)        (p)->GetVideoLine(a)
#define IVideoPort_GetVideoSignalStatus(p,a)    (p)->GetVideoSignalStatus(a)
#define IVideoPort_SetColorControls(p,a)    (p)->SetColorControls(a)
#define IVideoPort_StartVideo(p,a)      (p)->StartVideo(a)
#define IVideoPort_StopVideo(p)         (p)->StopVideo()
#define IVideoPort_UpdateVideo(p,a)     (p)->UpdateVideo(a)
#define IVideoPort_WaitForSync(p,a,b,c)     (p)->WaitForSync(a,b,c)
#endif
 
 
 
/*
 * DDVIDEOPORTCONNECT
 */
typedef struct _DDVIDEOPORTCONNECT
{
    DWORD dwSize;           
    DWORD dwPortWidth;      
    GUID  guidTypeID;       
    DWORD dwFlags;          
    DWORD dwReserved1;      
} DDVIDEOPORTCONNECT;
 
 
/*
 * DDVIDEOPORTCAPS
 */
typedef struct _DDVIDEOPORTCAPS
{
    DWORD dwSize;           
    DWORD dwFlags;          
    DWORD dwMaxWidth;           
    DWORD dwMaxVBIWidth;        
    DWORD dwMaxHeight;          
    DWORD dwVideoPortID;        
    DWORD dwCaps;           
    DWORD dwFX;             
    DWORD dwNumAutoFlipSurfaces;    
    DWORD dwAlignVideoPortBoundary; 
    DWORD dwAlignVideoPortPrescaleWidth;
    DWORD dwAlignVideoPortCropBoundary; 
    DWORD dwAlignVideoPortCropWidth;    
    DWORD dwPreshrinkXStep;     
    DWORD dwPreshrinkYStep;     
    DWORD dwNumVBIAutoFlipSurfaces; 
    DWORD dwReserved1;          
    DWORD dwReserved2;          
} DDVIDEOPORTCAPS;
 
#define DDVPD_WIDTH     0x00000001l
 
#define DDVPD_HEIGHT        0x00000002l
 
#define DDVPD_ID        0x00000004l
 
#define DDVPD_CAPS      0x00000008l
 
#define DDVPD_FX        0x00000010l
 
#define DDVPD_AUTOFLIP      0x00000020l
 
#define DDVPD_ALIGN     0x00000040l
 
 
/*
 * DDVIDEOPORTDESC
 */
typedef struct _DDVIDEOPORTDESC
{
    DWORD dwSize;           
    DWORD dwFieldWidth;         
    DWORD dwVBIWidth;           
    DWORD dwFieldHeight;        
    DWORD dwMicrosecondsPerField;   
    DWORD dwMaxPixelsPerSecond;     
    DWORD dwVideoPortID;        
    DWORD dwReserved1;          
    DDVIDEOPORTCONNECT VideoPortType;   
    DWORD dwReserved2;          
    DWORD dwReserved3;          
} DDVIDEOPORTDESC;
 
 
/*
 * DDVIDEOPORTINFO
 */
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;          
    DWORD dwReserved1;          
    DWORD dwReserved2;          
} DDVIDEOPORTINFO;
 
 
/*
 * DDVIDEOPORTBANDWIDTH
 */
typedef struct _DDVIDEOPORTBANDWIDTH
{
    DWORD dwSize;           
    DWORD dwCaps;
    DWORD dwOverlay;                
    DWORD dwColorkey;           
    DWORD dwYInterpolate;       
    DWORD dwYInterpAndColorkey;     
    DWORD dwReserved1;          
    DWORD dwReserved2;          
} DDVIDEOPORTBANDWIDTH;
 
 
/*
 * DDVIDEOPORTSTATUS
 */
typedef struct _DDVIDEOPORTSTATUS
{
    DWORD dwSize;           
    BOOL  bInUse;           
    DWORD dwFlags;                  
    DWORD dwReserved1;          
    DDVIDEOPORTCONNECT VideoPortType;   
    DWORD dwReserved2;          
    DWORD dwReserved3;          
} DDVIDEOPORTSTATUS;
 
/*============================================================================
 *
 * Video Port Flags
 *
 * All flags are bit flags.
 *
 *==========================================================================*/
 
/****************************************************************************
 *
 * VIDEOPORT DDVIDEOPORTCONNECT FLAGS
 *
 ****************************************************************************/
 
#define DDVPCONNECT_DOUBLECLOCK         0x00000001l
 
#define DDVPCONNECT_VACT            0x00000002l
 
#define DDVPCONNECT_INVERTPOLARITY      0x00000004l
 
#define DDVPCONNECT_DISCARDSVREFDATA        0x00000008l
 
#define DDVPCONNECT_HALFLINE            0x00000010l
 
#define DDVPCONNECT_INTERLACED          0x00000020l
 
#define DDVPCONNECT_SHAREEVEN           0x00000040l
 
#define DDVPCONNECT_SHAREODD            0x00000080l
 
/****************************************************************************
 *
 * VIDEOPORT DDVIDEOPORTDESC CAPS
 *
 ****************************************************************************/
 
#define DDVPCAPS_AUTOFLIP           0x00000001l
 
#define DDVPCAPS_INTERLACED         0x00000002l
 
#define DDVPCAPS_NONINTERLACED          0x00000004l
 
#define DDVPCAPS_READBACKFIELD          0x00000008l
 
#define DDVPCAPS_READBACKLINE           0x00000010l
 
#define DDVPCAPS_SHAREABLE          0x00000020l
 
#define DDVPCAPS_SKIPEVENFIELDS         0x00000040l
 
#define DDVPCAPS_SKIPODDFIELDS          0x00000080l
 
#define DDVPCAPS_SYNCMASTER         0x00000100l
 
#define DDVPCAPS_VBISURFACE         0x00000200l
 
#define DDVPCAPS_COLORCONTROL           0x00000400l
 
#define DDVPCAPS_OVERSAMPLEDVBI         0x00000800l
 
#define DDVPCAPS_SYSTEMMEMORY           0x00001000l
 
 
/****************************************************************************
 *
 * VIDEOPORT DDVIDEOPORTDESC FX
 *
 ****************************************************************************/
 
#define DDVPFX_CROPTOPDATA          0x00000001l
 
#define DDVPFX_CROPX                0x00000002l
 
#define DDVPFX_CROPY                0x00000004l
 
#define DDVPFX_INTERLEAVE           0x00000008l
 
#define DDVPFX_MIRRORLEFTRIGHT          0x00000010l
 
#define DDVPFX_MIRRORUPDOWN         0x00000020l
 
#define DDVPFX_PRESHRINKX           0x00000040l
 
#define DDVPFX_PRESHRINKY           0x00000080l
 
#define DDVPFX_PRESHRINKXB          0x00000100l
 
#define DDVPFX_PRESHRINKYB          0x00000200l
 
#define DDVPFX_PRESHRINKXS          0x00000400l
 
#define DDVPFX_PRESHRINKYS          0x00000800l
 
#define DDVPFX_PRESTRETCHX          0x00001000l
 
#define DDVPFX_PRESTRETCHY          0x00002000l
 
#define DDVPFX_PRESTRETCHXN         0x00004000l
 
#define DDVPFX_PRESTRETCHYN         0x00008000l
 
#define DDVPFX_VBICONVERT           0x00010000l
 
#define DDVPFX_VBINOSCALE           0x00020000l
 
#define DDVPFX_IGNOREVBIXCROP           0x00040000l
 
 
/****************************************************************************
 *
 * VIDEOPORT DDVIDEOPORTINFO FLAGS
 *
 ****************************************************************************/
 
#define DDVP_AUTOFLIP               0x00000001l
 
#define DDVP_CONVERT                0x00000002l
 
#define DDVP_CROP               0x00000004l
 
#define DDVP_INTERLEAVE             0x00000008l
 
#define DDVP_MIRRORLEFTRIGHT            0x00000010l
 
#define DDVP_MIRRORUPDOWN           0x00000020l
 
#define DDVP_PRESCALE               0x00000040l
 
#define DDVP_SKIPEVENFIELDS         0x00000080l
 
#define DDVP_SKIPODDFIELDS          0x00000100l
 
#define DDVP_SYNCMASTER             0x00000200l
 
#define DDVP_VBICONVERT             0x00000400l
 
#define DDVP_VBINOSCALE             0x00000800l
 
#define DDVP_OVERRIDEBOBWEAVE           0x00001000l
 
#define DDVP_IGNOREVBIXCROP         0x00002000l
 
 
/****************************************************************************
 *
 * DIRIRECTDRAWVIDEOPORT GETINPUTFORMAT/GETOUTPUTFORMAT FLAGS
 *
 ****************************************************************************/
 
#define DDVPFORMAT_VIDEO            0x00000001l
 
#define DDVPFORMAT_VBI              0x00000002l
 
 
/****************************************************************************
 *
 * DIRIRECTDRAWVIDEOPORT SETTARGETSURFACE FLAGS
 *
 ****************************************************************************/
 
#define DDVPTARGET_VIDEO            0x00000001l
 
#define DDVPTARGET_VBI              0x00000002l
 
 
/****************************************************************************
 *
 * DIRIRECTDRAWVIDEOPORT WAITFORSYNC FLAGS
 *
 ****************************************************************************/
 
#define DDVPWAIT_BEGIN              0x00000001l
 
#define DDVPWAIT_END                0x00000002l
 
#define DDVPWAIT_LINE               0x00000003l
 
/****************************************************************************
 *
 * DIRECTDRAWVIDEOPORT FLIP FLAGS
 *
 ****************************************************************************/
 
#define DDVPFLIP_VIDEO              0x00000001l
 
#define DDVPFLIP_VBI                0x00000002l
 
/****************************************************************************
 *
 * DIRIRECTDRAWVIDEOPORT GETVIDEOSIGNALSTATUS VALUES
 *
 ****************************************************************************/
 
#define DDVPSQ_NOSIGNAL             0x00000001l
 
#define DDVPSQ_SIGNALOK             0x00000002l
 
/****************************************************************************
 *
 * VIDEOPORTBANDWIDTH Flags
 *
 ****************************************************************************/
 
#define DDVPB_VIDEOPORT             0x00000001l
 
#define DDVPB_OVERLAY               0x00000002l
 
#define DDVPB_TYPE              0x00000004l
 
/****************************************************************************
 *
 * VIDEOPORTBANDWIDTH Caps
 *
 ****************************************************************************/
 
#define DDVPBCAPS_SOURCE            0x00000001l
 
#define DDVPBCAPS_DESTINATION           0x00000002l
 
 
#ifdef __cplusplus
};
#endif
 
#endif