ddraw.htm

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

    </b><p><font face="Arial">IDirectDraw2::SetDisplayMode</font>，<font face="Arial">IDirectDraw2::RestoreDisplayMode,</font>，<font
    face="Arial">IDirectDraw2::EnumDisplayModes</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#0000ff"><b>
    <li><font face="Arial"><a name="IDirectDraw2::GetFourCCCodes">IDirectDraw2::GetFourCCCodes</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p>获得<font face="Arial">DirectDraw</font>对象所支持的<font face="Arial">FOURCC</font>代码，也可获得所支持的代码个数。</p>
    <p><font face="Arial">HRESULT GetFourCCCodes(</font></p>
    <p><font face="Arial">LPDWORD lpNumCodes, </font></p>
    <p><font face="Arial">LPDWORD lpCodes </font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lpNumCodes</font></p>
    <p>一个<font face="Arial">DWORD</font>型变量的地址，包含了<font face="Arial">lpCodes</font>参数可以容纳的<font
    face="Arial">FOURCC</font>代码入口的个数。如果入口的个数太小以致于不能容纳所有的<font
    face="Arial">FOURCC</font>代码，<font face="Arial">lpNumCodes</font>将被设为所请求的个数，并且<font
    face="Arial">lpCodes</font>所指向的序列将填入适当的代码。</p>
    <p><font face="Arial">lpCodes</font></p>
    <p>一个<font face="Arial">DWORD</font>型变量序列的地址，将被填充该<font
    face="Arial">DirectDraw</font>对象所支持的<font face="Arial">FOURCC</font>代码。如果给该参数指定了<font
    face="Arial">NULL</font>，<font face="Arial">lpNumCodes</font>参数将返回该<font
    face="Arial">DirectDraw</font>对象所支持的<font face="Arial">FOURCC</font>代码的种类个数。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#0000ff"><b>
    <li><font face="Arial"><a name="IDirectDraw2::GetGDISurface">IDirectDraw2::GetGDISurface</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p>获得当前<font face="Arial">GDI</font>视为主页面的<font face="Arial">DirectDrawSurface</font>对象。</p>
    <p><font face="Arial">HRESULT GetGDISurface(</font></p>
    <p><font face="Arial">LPDIRECTDRAWSURFACE FAR *lplpGDIDDSSurface </font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lplpGDIDDSSurface</font></p>
    <p>一个指向<font face="Arial">DirectDrawSurface</font>对象的指针的地址，该<font
    face="Arial">DirectDrawSurface</font>对是当前<font face="Arial">GDI</font>所控制的主页面内存。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <p><font face="Arial">DDERR_NOTFOUND </font></p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    <b><p>请参阅：</p>
    </b><p><font face="Arial">IDirectDraw2::FlipToGDISurface</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#0000ff"><b>
    <li><font face="Arial"><a name="IDirectDraw2::GetMonitorFrequency">IDirectDraw2::GetMonitorFrequency</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p>获得<font face="Arial">DirectDraw</font>对象驱动的显示器的刷新频率。</p>
    <p><font face="Arial">HRESULT GetMonitorFrequency(</font></p>
    <p><font face="Arial">LPDWORD lpdwFrequency </font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lpdwFrequency</font></p>
    <p>一个变量的地址，将获得显示器的刷新频率，单位为：<font
    face="Arial">Hz</font>。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <p><font face="Arial">DDERR_UNSUPPORTED </font></p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#ff0000"><b>
    <li><font face="Arial"><a name="IDirectDraw2::GetScanLine">IDirectDraw2::GetScanLine</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p><font face="Arial">The IDirectDraw2::GetScanLine method retrieves the scan line that is 
    currently being drawn on the monitor.</font></p>
    <p><font face="Arial">HRESULT GetScanLine(</font></p>
    <p><font face="Arial">LPDWORD lpdwScanLine</font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lpdwScanLine</font></p>
    <p>一个变量的地址，将获得当前显示扫描线的位置。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <p><font face="Arial">DDERR_UNSUPPORTED </font></p>
    <p><font face="Arial">DDERR_VERTICALBLANKINPROGRESS </font></p>
    <b><p>备注：</p>
    </b><p>扫描线（<font face="Arial">Scan lines</font>）的位置是一个以<font
    face="Arial">0</font>为下限的整数。返回的扫描线的值范围处于<font
    face="Arial">0</font>到<font face="Arial">n</font>之间，<font face="Arial">0</font>是屏幕上第一条可见的扫描线，<font
    face="Arial">n</font>是最后一条可见的扫描线，加上了所有的</p>
    <p><font face="Arial">Scan lines are reported as zero-based integers. The returned scan 
    line value is between 0 and n, where scan line 0 is the first visible scan line on the 
    screen and n is the last visible scan line, plus any scan lines that occur during vblank. 
    So, in a case where an application is running at 640480, and there are 12 scan lines 
    during vblank, the values returned by this method will range from 0 to 491.</font></p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    <b><p>请参阅：</p>
    </b><p><font face="Arial">IDirectDraw2::GetVerticalBlankStatus, 
    IDirectDraw2::WaitForVerticalBlank</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#ff0000"><b>
    <li><font face="Arial"><a name="IDirectDraw2::GetVerticalBlankStatus">IDirectDraw2::GetVerticalBlankStatus</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p><font face="Arial">The IDirectDraw2::GetVerticalBlankStatus method retrieves the status 
    of the vertical blank.</font></p>
    <p><font face="Arial">HRESULT GetVerticalBlankStatus(</font></p>
    <p><font face="Arial">LPBOOL lpbIsInVB </font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lpbIsInVB</font></p>
    <p><font face="Arial">Address of the variable that will be filled with the status of the 
    vertical blank. This parameter is TRUE if a vertical blank is occurring, and FALSE 
    otherwise.</font></p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <b><p>备注：</p>
    </b><p><font face="Arial">To synchronize with the vertical blank, use the 
    IDirectDraw2::WaitForVerticalBlank method.</font></p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    <b><p>请参阅：</p>
    </b><p><font face="Arial">IDirectDraw2::GetScanLine, IDirectDraw2::WaitForVerticalBlank</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#0000ff"><b>
    <li><font face="Arial"><a name="IDirectDraw2::Initialize">IDirectDraw2::Initialize</a></font></li>
    </b></font><font SIZE="3"><p align="right"></font><font color="#FF0000" SIZE="3"><span
    style="color: rgb(255,0,0)"><a href="#目录">回到目录</a></span></font><font SIZE="3"></p>
    <p>该函数初始化一个用<font face="Arial">CoCreateInstance COM</font>函数创建的<font
    face="Arial">DirectDraw</font>对象。<font face="Arial">.</font></p>
    <p><font face="Arial">HRESULT Initialize(</font></p>
    <p><font face="Arial">GUID FAR *lpGUID </font></p>
    <p><font face="Arial">);</font></p>
    <b><p>参数：</p>
    </b><p><font face="Arial">lpGUID</font></p>
    <p>全局唯一标志符（<font face="Arial">GUID</font>）的地址，用做接口标志符。</p>
    <b><p>返回值：</p>
    </b><p>如果函数调用成功，返回<font face="Arial">DD_OK</font>。</p>
    <p>如果函数调用失败，返回值可能是下列错误值之一：</p>
    <p><font face="Arial">DDERR_ALREADYINITIALIZED </font></p>
    <p><font face="Arial">DDERR_DIRECTDRAWALREADYCREATED </font></p>
    <p><font face="Arial">DDERR_GENERIC </font></p>
    <p><font face="Arial">DDERR_INVALIDOBJECT </font></p>
    <p><font face="Arial">DDERR_INVALIDPARAMS </font></p>
    <p><font face="Arial">DDERR_NODIRECTDRAWHW </font></p>
    <p><font face="Arial">DDERR_NODIRECTDRAWSUPPORT </font></p>
    <p><font face="Arial">DDERR_OUTOFMEMORY </font></p>
    <p>这个函数是为了符合部件对象模型（<font face="Arial">COM</font>）的协议而提供。如果该<font
    face="Arial">DirectDraw</font>对象是由调用<font face="Arial">DirectDrawCreate</font>函数创建的，该函数返回<font
    face="Arial">DDERR_ALREADYINITIALIZED</font>。如果在使用<font face="Arial">CoCreateInstance 
    </font>创建一<font face="Arial">DirectDraw</font>对象后，没有调用<font
    face="Arial">IDirectDraw2::Initialize</font>，对该<font face="Arial">DirectDraw</font>对象的任何使用都将导致一个<font
    face="Arial">DDERR_NOTINITIALIZED</font>的错误。</p>
    <b><p>备注：</p>
    </b><p>要得到更多的关于如何使用<font face="Arial">IDirectDraw2::Initialize</font>和<font
    face="Arial">CoCreateInstance</font>的资料，请参阅：用<font face="Arial">CoCreateInstance</font>创建<font
    face="Arial">DirectDraw</font>对象。</p>
    <b><p>快速信息：</p>
    </b><p><font face="Arial">Windows NT</font>：适用于<font face="Arial">4.0</font>或更新版</p>
    <p><font face="Arial">Windows</font>：适用于<font face="Arial">Windows 95</font>或更新版</p>
    <p><font face="Arial">Windows CE</font>：不支持</p>
    <p>头文件：<font face="Arial">ddraw.h</font></p>
    <p>库文件：<font face="Arial">ddraw.lib</font></p>
    </font><hr>
    <font SIZE="3" COLOR="#0000ff"><b>