ddsurface.htm

DirecetX中文手册

    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpDDBltBatch</p>
    </font><font FACE="宋体" SIZE="3"><p>第一个</font><font FACE="Arial" SIZE="3">DDBLTBATCH</font><font
    FACE="宋体" SIZE="3">结构的地址，定义了位块传送操作的各参数。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwCount</p>
    </font><font FACE="宋体" SIZE="3"><p>位块传送操作的次数。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwFlags</p>
    </font><font FACE="宋体" SIZE="3"><p>该参数目前尚未使用，必须设为</font><font
    FACE="Arial" SIZE="3">0</font><font FACE="宋体" SIZE="3">。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_GENERIC </p>
    <p>DDERR_INVALIDCLIPLIST </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_INVALIDRECT </p>
    <p>DDERR_NOALPHAHW </p>
    <p>DDERR_NOBLTHW </p>
    <p>DDERR_NOCLIPLIST </p>
    <p>DDERR_NODDROPSHW </p>
    <p>DDERR_NOMIRRORHW </p>
    <p>DDERR_NORASTEROPHW </p>
    <p>DDERR_NOROTATIONHW </p>
    <p>DDERR_NOSTRETCHHW </p>
    <p>DDERR_NOZBUFFERHW </p>
    <p>DDERR_SURFACEBUSY </p>
    <p>DDERR_SURFACELOST </p>
    <p>DDERR_UNSUPPORTED </p>
    </font><font FACE="宋体" SIZE="3"><b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::BltFast">IDirectDrawSurface3::BltFast </a><blockquote>
        <p align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">返回目录</a></font><font
        FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
      </blockquote>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>通过使用源关键色或目标关键色，完成一次源图复制或带透明的位块传送。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT BltFast(</p>
    <p>DWORD dwX, </p>
    <p>DWORD dwY, </p>
    <p>LPDIRECTDRAWSURFACE3 lpDDSrcSurface, </p>
    <p>LPRECT lpSrcRect, </p>
    <p>DWORD dwTrans </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>dwX and dwY</p>
    </font><font FACE="宋体" SIZE="3"><p>目标页面上将被位块传送的</font><font
    FACE="Arial" SIZE="3">x</font><font FACE="宋体" SIZE="3">和</font><font FACE="Arial"
    SIZE="3">y</font><font FACE="宋体" SIZE="3">坐标。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpDDSrcSurface</p>
    <p>DirectDraw</font><font FACE="宋体" SIZE="3">页面的地址，作为位块传送操作的源页面。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpSrcRect</p>
    </font><font FACE="宋体" SIZE="3"><p>一个</font><font FACE="Arial" SIZE="3">RECT</font><font
    FACE="宋体" SIZE="3">结构的地址，定义了源页面上的矩形区域的左上和右下点坐标。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwTrans</p>
    </font><font FACE="宋体" SIZE="3"><p>传送类型。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDBLTFAST_DESTCOLORKEY </p>
    </font><font FACE="宋体" SIZE="3"><p>指定进行一次带透明的位块传送，使用目标页面的关键色。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDBLTFAST_NOCOLORKEY</p>
    </font><font FACE="宋体" SIZE="3"><p>指定进行一次普通的复制，不带透明成分。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDBLTFAST_SRCCOLORKEY</p>
    </font><font FACE="宋体" SIZE="3"><p>指定进行一次带透明的位块传送，使用源页面的关键色。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDBLTFAST_WAIT</p>
    </font><font FACE="宋体" SIZE="3"><p>如果位块传送器正忙，延迟</font><font
    FACE="Arial" SIZE="3">DDERR_WASSTILLDRAWING</font><font FACE="宋体" SIZE="3">消息的发送，直到位块传送器准备好或发生其它错误时才返回。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_EXCEPTION </p>
    <p>DDERR_GENERIC </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_INVALIDRECT </p>
    <p>DDERR_NOBLTHW </p>
    <p>DDERR_SURFACEBUSY </p>
    <p>DDERR_SURFACELOST </p>
    <p>DDERR_UNSUPPORTED </p>
    <p>DDERR_WASSTILLDRAWING</p>
    </font><font FACE="宋体" SIZE="3"><b><p>备注：</p>
    </b><p>该函数总是试图以异步的方式进行位块传送，如果硬件支持的话。</p>
    <p>该函数只针对显存中的页面工作，并且在操作过程中不能进行裁剪。如果你对一个拥有裁剪区的页面进行该项操作，调用失败，返回</font><font
    FACE="Arial" SIZE="3">DDERR_UNSUPPORTED</font><font FACE="宋体" SIZE="3">。</p>
    <p>软件执行时，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::BltFast</font><font
    FACE="宋体" SIZE="3">比</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::Blt</font><font
    FACE="宋体" SIZE="3">能提高</font><font FACE="Arial" SIZE="3">10%</font><font
    FACE="宋体" SIZE="3">的操作速度。然而，如果有硬件支持，这两个函数都将使用硬件加速，那么在速度上，这两各函数是没有区别的。</p>
    <p>典型的，如果位块传送器正忙或没有准备好，调用</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::BltFast</font><font FACE="宋体" SIZE="3">函数将立即返回一个错误。你可以指定</font><font
    FACE="Arial" SIZE="3">DDBLTFAST_WAIT</font><font FACE="宋体" SIZE="3">标志，那么，函数将一直等到位图传送器空闲或有其它错误发生时才返回。</p>
    <b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::DeleteAttachedSurface">IDirectDrawSurface3::DeleteAttachedSurface 
      </a><blockquote>
        <p align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">返回目录</a></font><font
        FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
      </blockquote>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>解除两个页面之间的隶属关系。被脱离的页面不会被释放。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT DeleteAttachedSurface(</p>
    <p>DWORD dwFlags, </p>
    <p>LPDIRECTDRAWSURFACE3 lpDDSAttachedSurface </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>dwFlags</p>
    </font><font FACE="宋体" SIZE="3"><p>该参数目前没有使用，只能设为</font><font
    FACE="Arial" SIZE="3">0</font><font FACE="宋体" SIZE="3">。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpDDSAttachedSurface</p>
    </font><font FACE="宋体" SIZE="3"><p>将被解除隶属关系的</font><font
    FACE="Arial" SIZE="3">DirectDraw</font><font FACE="宋体" SIZE="3">页面的地址。如果为</font><font
    FACE="Arial" SIZE="3">NULL</font><font FACE="宋体" SIZE="3">，所有相隶属的页面将相互脱离。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_CANNOTDETACHSURFACE </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_SURFACELOST </p>
    <p>DDERR_SURFACENOTATTACHED </p>
    </font><font FACE="宋体" SIZE="3"><b><p>备注：</p>
    </b><p>隐含的隶属关系，如由</font><font FACE="Arial" SIZE="3">DirectDraw</font><font
    FACE="宋体" SIZE="3">自动生成的而非调用</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::AddAttachedSurface</font><font
    FACE="宋体" SIZE="3">函数生成的，不能被脱离。解除换页链中页面的隶属关系，将改变链中其余页面的地位。例如，如果前台缓冲区从换页链中脱离，链中的下一个页面将成为前台缓冲区，再下一个页面会成为后台缓冲区。如果一个后台缓冲区从链中脱离，链中的下一个页面会成为后台缓冲区。如果一个简单页面从链中脱离，那么链仅仅是缩短了。如果一个换页链中仅有两个页面，当它们被脱离后，链将被销毁，并且两个页面都会返回到它们以前最基本的状态。</p>
    <b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><font FACE="宋体" SIZE="3"><b><p>请参阅：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>IDirectDrawSurface3::Flip</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::EnumAttachedSurfaces">IDirectDrawSurface3::EnumAttachedSurfaces 
      </a><blockquote>
        <p align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">返回目录</a></font><font
        FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
      </blockquote>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>列举出该页面的所有隶属页面。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT EnumAttachedSurfaces(</p>
    <p>LPVOID lpContext, </p>
    <p>LPDDENUMSURFACESCALLBACK lpEnumSurfacesCallback </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpContext</p>
    </font><font FACE="宋体" SIZE="3"><p>一个用户定义的结构的地址，每列举出一个页面的时候，它将被传递给列举的回调函数。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpEnumSurfacesCallback</p>
    <p>EnumSurfacesCallback</font><font FACE="宋体" SIZE="3">回调函数的地址，每列举出一个页面的时候，这个函数将被调用。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回</font><font FACE="Arial" SIZE="3">DD_OK</font><font
    FACE="宋体" SIZE="3">。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_SURFACELOST </p>
    </font><font FACE="宋体" SIZE="3"><b><p>快速信息：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>Windows NT</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">4.0</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows</font><font FACE="宋体" SIZE="3">：适用于</font><font
    FACE="Arial" SIZE="3">Windows 95</font><font FACE="宋体" SIZE="3">或更新版</p>
    </font><font FACE="Arial" SIZE="3"><p>Windows CE</font><font FACE="宋体" SIZE="3">：不支持</p>
    <p>头文件：</font><font FACE="Arial" SIZE="3">ddraw.h</p>
    </font><font FACE="宋体" SIZE="3"><p>库文件：</font><font FACE="Arial" SIZE="3">ddraw.lib</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::EnumOverlayZOrders">IDirectDrawSurface3::EnumOverlayZOrders</a><blockquote>
        <p align="right"></font><font SIZE="3" COLOR="#0000ff"><a href="#目录">返回目录</a></font><font
        FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
      </blockquote>
    </li>
    </font></b><font FACE="宋体" SIZE="3"><p>列举出在该页面之上的覆盖页面。可以按照从前往后，也可以按照从后往前的顺序。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT EnumOverlayZOrders(</p>
    <p>DWORD dwFlags, </p>