ddsurface.htm

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

        href="#IDirectDrawSurface3::UpdateOverlayDisplay">UpdateOverlayDisplay</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::UpdateOverlayZOrder">UpdateOverlayZOrder</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"><font FACE="宋体" SIZE="3"><b>页面性能</b></font></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::GetCaps">GetCaps</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"><font FACE="宋体" SIZE="3"><b>页面裁剪</b></font></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::GetClipper">GetClipper</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::SetClipper">SetClipper</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"><font FACE="宋体" SIZE="3"><b>页面描述</b></font></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::GetPixelFormat">GetPixelFormat</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::GetSurfaceDesc">GetSurfaceDesc</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::SetSurfaceDesc">SetSurfaceDesc</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"><font FACE="宋体" SIZE="3"><b>页面调色板</b></font></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::GetPalette">GetPalette</a></font></td>
      </tr>
      <tr>
        <td WIDTH="42%" VALIGN="TOP"></td>
        <td WIDTH="58%" VALIGN="TOP"><font SIZE="3" face="Arial"><a
        href="#IDirectDrawSurface3::SetPalette">SetPalette</a></font></td>
      </tr>
    </table>
  </blockquote>
  <font SIZE="3"><p>和所有<font face="Arial">COM</font>接口一样，<font face="Arial">IDirectDrawSurface3</font>接口由<font
  face="Arial">IUnknown</font>接口衍生而来。<font face="Arial">IUnknown</font>接口支持以下三种方法：<ol>
    <p><font face="Arial">AddRef<br>
    QueryInterface<br>
    Release </font></p>
    </font>
  </ol>
  <font SIZE="3"><p>你可以使用<font face="Arial">LPDIRECTDRAWSURFACE</font>，<font
  face="Arial">LPDIRECTDRAWDURFACE2</font>，或<font face="Arial">LPDIRECTDRAWSURFACE3</font>数据类型来声明一个指向<font
  face="Arial">IDirectDrawSurface</font>，<font face="Arial">IDirectDrawSurface2</font>，或<font
  face="Arial">IDirectDrawSurface3</font>接口的指针变量。在<font face="Arial">Ddraw.h</font>头文件中，用如下代码声明了这三种数据类型。</font><ol>
    <font SIZE="3"><p><font face="Arial">typedef struct IDirectDrawSurface FAR 
    *LPDIRECTDRAWSURFACE;<br>
    typedef struct IDirectDrawSurface2 FAR *LPDIRECTDRAWSURFACE2;<br>
    typedef struct IDirectDrawSurface3 FAR *LPDIRECTDRAWSURFACE3;</font></p>
    </font>
  </ol>
</blockquote>

<blockquote>
  <hr>
</blockquote>

<ol>
  <ol>
    <font FACE="Arial" SIZE="3" COLOR="#0000ff"><b>
    <li><a name="IDirectDrawSurface3::AddAttachedSurface">IDirectDrawSurface3::AddAttachedSurface</a></li>
    </b></font>
  </ol>
</ol>

<blockquote>
  <p align="right"><b><font SIZE="3" color="#FF0000"><a href="#目录">返回目录</a></font><font
  FACE="Arial" SIZE="3" COLOR="#0000ff"></p>
  </font></b>
</blockquote>

<ol>
  <ol>
    <font FACE="宋体" SIZE="3"><p>将一个页面隶属于另一个页面。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT AddAttachedSurface( </p>
    <p>LPDIRECTDRAWSURFACE3 lpDDSAttachedSurface </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></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">页面的地址。</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_CANNOTATTACHSURFACE </p>
    <p>DDERR_GENERIC </p>
    <p>DDERR_INVALIDOBJECT </p>
    <p>DDERR_INVALIDPARAMS </p>
    <p>DDERR_SURFACEALREADYATTACHED </p>
    <p>DDERR_SURFACELOST </p>
    <p>DDERR_WASSTILLDRAWING </p>
    </font><font FACE="宋体" SIZE="3"><b><p>备注：</p>
    </b><p>可以被隶属的页面类型包括：</font><font FACE="Arial" SIZE="3">z-</font><font
    FACE="宋体" SIZE="3">缓冲区、</font><font FACE="Arial" SIZE="3">alpha</font><font
    FACE="宋体" SIZE="3">通道、和后台缓冲区。某些隶属关系可能会打破另一些隶属关系。例如，一个</font><font
    FACE="Arial" SIZE="3">3-D z-</font><font FACE="宋体" SIZE="3">缓冲区一次只能隶属到一个后台缓冲区上去。隶属关系不是双向的，并且一个页面不可能隶属到自身。仿真页面（在系统主存中）不能隶属到一个非仿真页面上去。除非页面是材质图，否则两个隶属关系的页面必须是相同的大小。一个换页页面不能被隶属到另一个相同类型的换页页面上去；然而，将两个不同类型的页面相隶属却是可行的。例如，一个换页</font><font
    FACE="Arial" SIZE="3">z-</font><font FACE="宋体" SIZE="3">缓冲区可以被隶属到普通换页页面上去。如果一个非换页页面被隶属到另一个非换页页面上，这两个页面将形成一个换页链。如果一个非换页页面被隶属到一个换页页面上，它就会成为这个换页链的一部分。其它的页面也可以被隶属到这个换页链中，并且每次调用</font><font
    FACE="Arial" SIZE="3">IDirectDrawSurface3::Flip</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::DeleteAttachedSurface</font><font
    FACE="宋体" SIZE="3">，</font><font FACE="Arial" SIZE="3">IDirectDrawSurface3::EnumAttachedSurfaces</font><font
    FACE="宋体" SIZE="3">。</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::AddOverlayDirtyRect">IDirectDrawSurface3::AddOverlayDirtyRect</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 AddOverlayDirtyRect(</p>
    <p>LPRECT lpRect </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpRect</p>
    <p>RECT</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_INVALIDSURFACETYPE </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><font FACE="宋体" SIZE="3"><b><p>请参阅：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>IDirectDrawSurface3::UpdateOverlayDisplay</p>
    </font><hr>
    <b><font FACE="Arial" SIZE="3" COLOR="#0000ff">
    <li><a name="IDirectDrawSurface3::Blt">IDirectDrawSurface3::Blt</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>该函数完成一次位块传送（</font><font
    FACE="Arial" SIZE="3">bit block transfer</font><font FACE="宋体" SIZE="3">）操作。目前它还不支持带</font><font
    FACE="Arial" SIZE="3">z-</font><font FACE="宋体" SIZE="3">缓冲区和</font><font
    FACE="Arial" SIZE="3">alpha</font><font FACE="宋体" SIZE="3">混合的位块传送操作（参见</font><font
    FACE="Arial" SIZE="3">alpha</font><font FACE="宋体" SIZE="3">通道）。</p>
    </font><font FACE="Arial" SIZE="3"><p>HRESULT Blt(</p>
    <p>LPRECT lpDestRect, </p>
    <p>LPDIRECTDRAWSURFACE3 lpDDSrcSurface, </p>
    <p>LPRECT lpSrcRect, </p>
    <p>DWORD dwFlags, </p>
    <p>LPDDBLTFX lpDDBltFx </p>
    <p>);</p>
    </font><font FACE="宋体" SIZE="3"><b><p>参数：</p>
    </b></font><font FACE="Arial" SIZE="3"><p>lpDestRect</p>