ddsurface.htm

DirectX 编程初级教程中文版。只要有C++基础和一点三维知识即可。

    <p>LPVOID lpContext, </p>
    <p>LPDDENUMSURFACESCALLBACK lpfnCallback </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>下列标志之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDENUMOVERLAYZ_BACKTOFRONT </p>
    </font><font FACE="宋体" SIZE="3"><p>从后往前列举覆盖页面。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDENUMOVERLAYZ_FRONTTOBACK </p>
    </font><font FACE="宋体" SIZE="3"><p>从前往后列举覆盖页面。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpContext</p>
    </font><font FACE="宋体" SIZE="3"><p>一个用户定义的结构的地址，每列举出一个覆盖页面的时候，它将被传递给列举的回调函数。</p>
    </font><font FACE="Arial" SIZE="3"><p>lpfnCallback</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>
    </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::Flip">IDirectDrawSurface3::Flip</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 Flip(</p>
    <p>LPDIRECTDRAWSURFACE3 lpDDSurfaceTargetOverride, </p>
    <p>DWORD dwFlags </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpDDSurfaceTargetOverride</p>
    </font><font FACE="宋体" SIZE="3"><p>换页链中另一个页面的地址，代表换页操作的目标页面。这个页面必须是换页链中的一员。该参数缺省值是</font><font
    FACE="Arial" SIZE="3">NULL</font><font FACE="宋体" SIZE="3">，在这种情况下，</font><font
    FACE="Arial" SIZE="3">DirectDraw</font><font FACE="宋体" SIZE="3">从换页链中按照前后隶属关系依次换页。</p>
    </font><font FACE="Arial" SIZE="3"><p>dwFlags </p>
    </font><font FACE="宋体" SIZE="3"><p>换页的标志选项：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDFLIP_EVEN</p>
    </font><font FACE="宋体" SIZE="3"><p>仅当在覆盖页面上显示视频图象时才能使用。新的页面上包含从视频信号的奇数行上传来的数据。该参数不能与</font><font
    FACE="Arial" SIZE="3">DDFLIP_ODD</font><font FACE="宋体" SIZE="3">标志同时使用。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDFLIP_ODD</p>
    </font><font FACE="宋体" SIZE="3"><p>仅当在覆盖页面上显示视频图象时才能使用。新的页面上包含从视频信号的偶数行上传来的数据。该参数不能与</font><font
    FACE="Arial" SIZE="3">DDFLIP_EVEN</font><font FACE="宋体" SIZE="3">标志同时使用。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDFLIP_WAIT </p>
    </font><font FACE="宋体" SIZE="3"><p>典型的，如果不使用该标志，因为显示硬件不在状态（因为上一次的换页尚未完成或其它原因）而导致换页操作没能准备好，函数将立即返回</font><font
    FACE="Arial" SIZE="3">DDERR_WASSTILLDRAWING</font><font FACE="宋体" SIZE="3">，并且不能完成换页操作。如果设置了该</font><font
    FACE="Arial" SIZE="3">DDFLIP_WAIT</font><font FACE="宋体" SIZE="3">标志，可以使该函数在收到从</font><font
    FACE="Arial" SIZE="3">HAL</font><font FACE="宋体" SIZE="3">传来的</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_GENERIC </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_NOFLIPHW </p>
    <p>DDERR_NOTFLIPPABLE </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>这个函数只能被具有</font><font FACE="Arial" SIZE="3">DDSCAPS_FLIP</font><font
    FACE="宋体" SIZE="3">和</font><font FACE="Arial" SIZE="3">DDSCAPS_FRONTBUFFER</font><font
    FACE="宋体" SIZE="3">标志的页面调用。先前与前台缓冲区相关联的页面内存在换页后与后台缓冲区相关联。</font><font
    FACE="Arial" SIZE="3">lpDDSurfaceTargetOverride</font><font FACE="宋体" SIZE="3">参数在很少情况下才被使用，通常，该参数为</font><font
    FACE="Arial" SIZE="3">NULL</font><font FACE="宋体" SIZE="3">。</p>
    </font><font FACE="Arial" SIZE="3"><p>IDirectDrawSurface3::Flip</font><font FACE="宋体"
    SIZE="3">函数总是与显示器的垂直回扫（</font><font FACE="Arial" SIZE="3"
    COLOR="#ff0000">vertical blank</font><font FACE="宋体" SIZE="3" COLOR="#ff0000">）</font><font
    FACE="宋体" SIZE="3">同步进行。如果页面被指派给了一个视频端口，该函数可更新可见的覆盖页面和视频端口的目标页面。</p>
    <p>要得到更多的资料，请参阅“换页页面”。</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::GetFlipStatus</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::GetAttachedSurface">IDirectDrawSurface3::GetAttachedSurface</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 GetAttachedSurface(</p>
    <p>LPDDSCAPS lpDDSCaps, </p>
    <p>LPDIRECTDRAWSURFACE3 FAR *lplpDDAttachedSurface </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpDDSCaps</p>
    <p>DDSCAPS</font><font FACE="宋体" SIZE="3">结构的地址，包含了页面的硬件特性描述。</p>
    </font><font FACE="Arial" SIZE="3"><p>lplpDDAttachedSurface</p>
    </font><font FACE="宋体" SIZE="3"><p>返回一个指向</font><font FACE="Arial"
    SIZE="3">IDirectDrawSurface</font><font FACE="宋体" SIZE="3">对象的指针地址。该页面符合</font><font
    FACE="Arial" SIZE="3">lpDDSCaps</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_NOTFOUND </p>
    <p>DDERR_SURFACELOST </p>
    </font><font FACE="宋体" SIZE="3"><b><p>备注：</p>
    </b><p>隶属关系用于将多个</font><font FACE="Arial" SIZE="3">DirectDrawSurface</font><font
    FACE="宋体" SIZE="3">对象合成一个复杂的页面结构，比如，如果页面要支持</font><font
    FACE="Arial" SIZE="3">3-D</font><font FACE="宋体" SIZE="3">换页，必须带一个</font><font
    FACE="Arial" SIZE="3">z-</font><font FACE="宋体" SIZE="3">缓冲区页面。如果该页面的隶属页面中有多于一个符合条件，则函数调用失败，在这种情况下，应用程序必须使用</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::EnumAttachedSurfaces</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::GetBltStatus">IDirectDrawSurface3::GetBltStatus</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 GetBltStatus(</p>
    <p>DWORD dwFlags </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>dwFlags</p>
    <p></font><font FACE="宋体" SIZE="3">下列标志之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDGBS_CANBLT</p>
    </font><font FACE="宋体" SIZE="3"><p>询问对该页面的位块传送操作是否能立即开始，如果返回</font><font
    FACE="Arial" SIZE="3">DD_OK</font><font FACE="宋体" SIZE="3">，表示位块传送器准备就绪。</p>
    </font><font FACE="Arial" SIZE="3"><p>DDGBS_ISBLTDONE</p>
    </font><font FACE="宋体" SIZE="3"><p>询问位块操作是否已经完成，如果返回</font><font
    FACE="Arial" SIZE="3">DD_OK</font><font FACE="宋体" SIZE="3">，表明对该页面的位块操作已经完成。</p>
    <b><p>返回值：</font><font SIZE="3"> </font><font FACE="Arial" SIZE="3"></p>
    </font></b><font FACE="宋体" SIZE="3"><p>如果函数成功，表明位图传送器处于待命状态，返回值是</font><font
    FACE="Arial" SIZE="3">DD_OK</font><font FACE="宋体" SIZE="3">。</p>
    <p>如果函数失败，返回</font><font FACE="Arial" SIZE="3">DDERR_WASSTILLDRAWING</font><font
    FACE="宋体" SIZE="3">表明位块传送器正忙，返回</font><font FACE="Arial"
    SIZE="3">DDERR_NOBLTHW</font><font FACE="宋体" SIZE="3">表明位块传送器不存在，或下列值之一：</p>
    </font><font FACE="Arial" SIZE="3"><p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </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></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::GetCaps">IDirectDrawSurface3::GetCaps</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 GetCaps(</p>
    <p>LPDDSCAPS lpDDSCaps </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpDDSCaps</p>
    </font><font FACE="宋体" SIZE="3"><p>一个</font><font FACE="Arial" SIZE="3">DDSCAPS</font><font
    FACE="宋体" SIZE="3">结构