Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

The following code example shows how to set the DirectDraw capability bits YV12 overlays that can be flipped.

Note:
To make the following code example easier to read, security checking and error handling are not included. This code example should not be used in a release configuration unless it has been modified to include them.
Copy Code 
#include "precomp.h"

DWORD g_FourCC[] = {
	FOURCC_YV12
};

#define MAX_FOURCC ( sizeof ( g_FourCC ) / sizeof( g_FourCC[0] ) )

// callbacks from the DIRECTDRAW object

DDHAL_DDCALLBACKS cbDDCallbacks =
{
	sizeof( DDHAL_DDCALLBACKS ),
		DDHAL_CB32_CREATESURFACE		|
		DDHAL_CB32_WAITFORVERTICALBLANK |
		DDHAL_CB32_CANCREATESURFACE	 |
//	DDHAL_CB32_CREATEPALETTE		|
//	DDHAL_CB32_GETSCANLINE		|
		0,
	DDGPECreateSurface,
	HalWaitForVerticalBlank,
	DDGPECanCreateSurface,
	NULL,
	NULL
};

// callbacks from the DIRECTDRAWSURFACE object

DDHAL_DDSURFACECALLBACKS cbDDSurfaceCallbacks =
{
	sizeof( DDHAL_DDSURFACECALLBACKS ),
		DDHAL_SURFCB32_DESTROYSURFACE	 |
		DDHAL_SURFCB32_FLIP			 |
		DDHAL_SURFCB32_LOCK			 |
		DDHAL_SURFCB32_UNLOCK			 |
		DDHAL_SURFCB32_SETCOLORKEY		|
		DDHAL_SURFCB32_GETBLTSTATUS	 |
		DDHAL_SURFCB32_GETFLIPSTATUS	|
		DDHAL_SURFCB32_UPDATEOVERLAY	|
		DDHAL_SURFCB32_SETOVERLAYPOSITION |
//	DDHAL_SURFCB32_SETPALETTE		 |
		0,
	DDGPEDestroySurface,
	HalFlip,
	DDGPELock,
	DDGPEUnlock,
	HalSetColorKey,
	HalGetBltStatus,
	DDGPEGetFlipStatus,
	HalUpdateOverlay,
	HalSetOverlayPosition,
	NULL,
};

// InitDDHALInfo must set up this information
unsigned long	g_nVideoMemorySize  = 0L;
unsigned char *  g_pVideoMemory	= NULL; // virtual address of
video
											 // memory from
client's side
DWORD			g_nTransparentColor = 0L;

EXTERN_C
void
buildDDHALInfo(
	LPDDHALINFO lpddhi,
	DWORD modeidx
	)
{
	GPEFlat * pGPEFlat = static_cast<GPEFlat *>(GetDDGPE());

	if( !g_pVideoMemory )   // in case this is called more than
once...
	{
		unsigned long VideoMemoryStart;

		pGPEFlat->GetVirtualVideoMemory( &VideoMemoryStart,
										 &g_nVideoMemorySize );
		DEBUGMSG( GPE_ZONE_INIT,
		(TEXT("GetVirtualVideoMemory returned addr=0x%08x
size=%d\r\n"),
		VideoMemoryStart, g_nVideoMemorySize));

		g_pVideoMemory = (BYTE*)VideoMemoryStart;
		DEBUGMSG( GPE_ZONE_INIT,
				 (TEXT("gpVidMem=%08x\r\n"), g_pVideoMemory ));
}

	memset( lpddhi, 0, sizeof(DDHALINFO) );  // Clear the DDHALINFO
											 // structure

	lpddhi->dwSize = sizeof(DDHALINFO);

	lpddhi->lpDDCallbacks = &cbDDCallbacks;
	lpddhi->lpDDSurfaceCallbacks = &cbDDSurfaceCallbacks;

	lpddhi->GetDriverInfo = HalGetDriverInfo;

	lpddhi->lpdwFourCC = g_FourCC;

	// Capability bits.

	lpddhi->ddCaps.dwSize = sizeof(DDCAPS);

	lpddhi->ddCaps.dwVidMemTotal  = g_nVideoMemorySize;
	lpddhi->ddCaps.dwVidMemFree   = g_nVideoMemorySize;
	lpddhi->ddCaps.dwVidMemStride = 0;

	lpddhi->ddCaps.ddsCaps.dwCaps =
		DDSCAPS_BACKBUFFER		|
		DDSCAPS_FRONTBUFFER		 |
		DDSCAPS_FLIP				|
		DDSCAPS_OVERLAY			 |
		DDSCAPS_PRIMARYSURFACE	|
		DDSCAPS_SYSTEMMEMORY		|
		DDSCAPS_VIDEOMEMORY		 |
		0;

	lpddhi->ddCaps.dwNumFourCCCodes = MAX_FOURCC;
	lpddhi->ddCaps.dwPalCaps = 0;
	lpddhi->ddCaps.dwMiscCaps = 0;

	// DirectDraw Blitting caps refer to hardware blitting support
only.

	lpddhi->ddCaps.dwBltCaps = 0;
	lpddhi->ddCaps.dwCKeyCaps =
		DDCKEYCAPS_SRCBLT	 |
		0;
	lpddhi->ddCaps.dwAlphaCaps = 0;

	// Set bits for ROPS supported
	SETROPBIT(lpddhi->ddCaps.dwRops,SRCCOPY);
	SETROPBIT(lpddhi->ddCaps.dwRops,PATCOPY);
	SETROPBIT(lpddhi->ddCaps.dwRops,BLACKNESS);
	SETROPBIT(lpddhi->ddCaps.dwRops,WHITENESS);

	// Overlay caps.

	lpddhi->ddCaps.dwOverlayCaps =
		DDOVERLAYCAPS_FLIP				|
		DDOVERLAYCAPS_CKEYSRC			 |
		DDOVERLAYCAPS_CKEYDEST			|
		DDOVERLAYCAPS_CKEYDESTCLRSPACEYUV |
		0;

	lpddhi->ddCaps.dwMaxVisibleOverlays = 1;
	lpddhi->ddCaps.dwCurrVisibleOverlays = 0;

	lpddhi->ddCaps.dwAlignBoundarySrc = 0;
	lpddhi->ddCaps.dwAlignSizeSrc = 0;
	lpddhi->ddCaps.dwAlignBoundaryDest = 0;
	lpddhi->ddCaps.dwAlignSizeDest = 0;
	lpddhi->ddCaps.dwMiscCaps =  0;

	lpddhi->ddCaps.dwMinOverlayStretch = 1000;
	lpddhi->ddCaps.dwMaxOverlayStretch = 1000;
}

See Also

Concepts

Overlay Surfaces