使用英语阅读

通过


DirectDraw

DirectDraw 技术概述。

若要开发 DirectDraw,需要以下标头:

有关此技术的编程指南,请参阅:

函数

 
AddAttachedSurface

将指定的 z 缓冲区图面附加到此图面。
AddOverlayDirtyRect

IDirectDrawSurface7::AddOverlayDirtyRect 方法当前未实现。
Blt

执行位块传输 (bitblt) 。 此方法在 bitblt 操作期间不支持 z 缓冲或 alpha 混合。
BltBatch

IDirectDrawSurface7::BltBatch 方法当前未实现。
BltFast

使用源颜色键或目标颜色键执行源复制 bitblt 或透明 bitblt。
ChangeUniquenessValue

手动更新此图面的唯一性值。
精简

目前未实现此方法。 (IDirectDraw7.Compact)
CreateClipper

创建 DirectDrawClipper 对象。
CreatePalette

为此 DirectDraw 对象创建 DirectDrawPalette 对象。
CreateSurface

为此 DirectDraw 对象创建 DirectDrawSurface 对象。
DeleteAttachedSurface

分离一个或多个附加表面。
DirectDrawCreate

创建 DirectDraw 对象的实例。
DirectDrawCreateClipper

创建不与 DirectDraw 对象关联的 DirectDrawClipper 对象的实例。
DirectDrawCreateEx

创建 DirectDraw 对象的实例,该对象支持 DirectX 7.0 中的一组 Direct3D 接口。 若要在 DirectX 7.0 中使用 Direct3D 的功能,请使用此函数创建 DirectDraw 对象。
DirectDrawEnumerateA

此函数由 DirectDrawEnumerateEx 函数取代。 (ANSI)
DirectDrawEnumerateExA

枚举计算机上安装的所有 DirectDraw 设备。 NULL 条目始终标识与 GDI 共享的主显示设备。 (ANSI)
DirectDrawEnumerateExW

枚举计算机上安装的所有 DirectDraw 设备。 NULL 条目始终标识与 GDI 共享的主显示设备。 (Unicode)
DirectDrawEnumerateW

此函数由 DirectDrawEnumerateEx 函数取代。 (Unicode)
DuplicateSurface

复制 DirectDrawSurface 对象。
EnumAttachedSurfaces

枚举附加到此图面的所有图面。
EnumDisplayModes

枚举硬件通过 DirectDraw 对象公开并与提供的表面说明兼容的所有显示模式。
EnumOverlayZOrders

枚举指定目标上的覆盖图面。 可以按从前到后或从后到前的顺序枚举覆盖层。
EnumSurfaces

枚举满足指定表面说明的所有现有或可能的图面。
EvaluateMode

在调用 IDirectDraw7::StartModeTest 后使用,以通过或失败测试呈现的每个模式,并单步执行模式,直到测试完成。
Flip

使与DDSCAPS_BACKBUFFER图面关联的表面内存与前缓冲区表面相关联。
FlipToGDISurface

使 GDI 写入主图面的图面。
FreePrivateData

释放与此图面关联的指定私有数据。
GetAttachedSurface

获取具有指定功能的附加图面,并递增检索到的接口的引用计数。
GetAvailableVidMem

检索给定类型图面的可用显示内存总量和当前可用的显示内存量。
GetBltStatus

获取有关位块传输 (bitblt) 操作的状态。
GetCaps

(HEL) 检索硬件和硬件仿真层的设备驱动程序的功能。
GetCaps

检索调色板对象的功能。
GetCaps

检索此图面的功能。 这些功能不一定与显示设备的功能相关。
GetClipList

检索与 DirectDrawClipper 对象关联的剪辑列表的副本。 若要选择剪辑列表的子集,可以传递一个用于剪辑该剪辑列表的矩形。
GetClipper

检索与此图面关联的 DirectDrawClipper 对象,并递增返回的剪辑器的引用计数。
GetColorControls

检索与覆盖或主图面关联的当前颜色控制设置。
GetColorKey

检索此图面的颜色键值。
GetDC

为此图面创建设备上下文的 GDI 兼容句柄。
GetDDInterface

检索用于创建此图面的 DirectDraw 对象的接口。
GetDeviceIdentifier

获取有关设备驱动程序的信息。 可以谨慎使用此方法来识别特定硬件安装,以实现驱动程序或芯片集行为不佳的解决方法。
GetDisplayMode

检索当前显示模式。
GetEntries

从 DirectDrawPalette 对象检索调色板值。
GetFlipStatus

检索有关此图面是否已完成翻转过程的状态。
GetFourCCCodes

检索 DirectDraw 对象支持的 FOURCC) (四个字符的代码。 此方法还可以检索支持的代码数。
GetGammaRamp

检索主要图面的红色、绿色和蓝色伽玛坡度。
GetGDISurface

检索 DirectDrawSurface 对象,该对象当前表示 GDI 作为主图面的图面内存。
GetHWnd

检索以前通过 IDirectDrawClipper::SetHWnd 方法与此 DirectDrawClipper 对象关联的窗口句柄。
GetLOD

检索当前为托管 mipmap 图面设置 (LOD) 的最大详细级别。 此方法仅在托管纹理上成功。
GetMonitorFrequency

检索 DirectDraw 对象控制的监视器的频率。
GetOverlayPosition

检索此图面的显示坐标。 此方法用于可见的活动覆盖图面 (即) 设置了DDSCAPS_OVERLAY标志的图面。
GetPalette

检索与此图面关联的 DirectDrawPalette 对象,并递增返回的调色板的引用计数。
GetPixelFormat

检索此图面的颜色和像素格式。
GetPriority

检索此纹理的纹理管理优先级。 此方法仅在托管纹理上成功。
GetPrivateData

将与此图面关联的专用数据复制到提供的缓冲区。
GetScanLine

检索当前在监视器上绘制的扫描线。
GetSurfaceDesc

检索此图面在其当前条件下的说明。
GetSurfaceFromDC

根据其 GDI 设备上下文句柄检索图面的 IDirectDrawSurface7 接口。
GetUniquenessValue

检索此图面的当前唯一性值。
GetVerticalBlankStatus

检索垂直空白的状态。
初始化

初始化使用 CoCreateInstance COM 函数创建的 DirectDraw 对象。
初始化

初始化使用 CoCreateInstance COM 函数创建的 DirectDrawClipper 对象。
初始化

初始化 DirectDrawPalette 对象。
初始化

初始化 DirectDrawSurface 对象。
IsClipListChanged

如果窗口句柄与 DirectDrawClipper 对象关联,则检索剪辑列表的状态。
IsLost

确定是否释放了与 DirectDrawSurface 对象关联的表面内存。
Lock

获取指向表面内存的指针。
LPDDENUMCALLBACKA

DDEnumCallback 函数是 DirectDrawEnumerate 函数的应用程序定义的回调函数。 (ANSI)
LPDDENUMCALLBACKEXA

DDEnumCallbackEx 函数是 DirectDrawEnumerateEx 函数的应用程序定义的回调函数。 (ANSI)
LPDDENUMCALLBACKEXW

DDEnumCallbackEx 函数是 DirectDrawEnumerateEx 函数的应用程序定义的回调函数。 (Unicode)
LPDDENUMCALLBACKW

DDEnumCallback 函数是 DirectDrawEnumerate 函数的应用程序定义的回调函数。 (Unicode)
LPDDENUMMODESCALLBACK

请勿使用。 此回调函数由与 IDirectDraw7::EnumDisplayModes 方法一起使用的 EnumModesCallback2 函数取代。
LPDDENUMMODESCALLBACK2

EnumModesCallback2 函数是 IDirectDraw7::EnumDisplayModes 方法的应用程序定义的回调函数。
LPDDENUMSURFACESCALLBACK

LPDDENUMSURFACESCALLBACK 函数 (ddraw.h) 由 EnumSurfacesCallback7 函数取代。
LPDDENUMSURFACESCALLBACK2

LPDDENUMSURFACESCALLBACK2 函数 (ddraw.h) 被 EnumSurfacesCallback7 函数取代。
LPDDENUMSURFACESCALLBACK7

EnumSurfacesCallback7 函数是 IDirectDrawSurface7::EnumAttachedSurfaces 和 IDirectDrawSurface7::EnumOverlayZOrders 方法的应用程序定义的回调函数。
PageLock

防止系统内存图面在位块传输 (bitblt) 操作时分页,该操作使用直接内存访问 (DMA) 传输系统内存内存。
PageUnlock

解锁系统内存图面,然后允许将其分页。
ReleaseDC

释放以前使用 IDirectDrawSurface7::GetDC 方法获取的设备上下文的句柄。
还原

还原已丢失的图面。 当释放与 DirectDrawSurface 对象关联的表面内存时,将发生这种情况。
RestoreAllSurfaces

按创建顺序还原为 DirectDraw 对象创建的所有图面。
RestoreDisplayMode

将主图面的显示设备硬件的模式重置为调用 IDirectDraw7::SetDisplayMode 方法之前的状态。 使用此方法需要独占级别访问权限。
SetClipList

设置或删除 IDirectDrawSurface7::Blt、IDirectDrawSurface7::BltBatch 和 IDirectDrawSurface7::UpdateOverlay 方法在父 DirectDrawClipper 对象所附加到的图面上使用的剪辑列表。
SetClipper

将剪辑器对象附加到此图面或从中删除一个对象。
SetColorControls

设置覆盖或主表面的颜色控制选项。
SetColorKey

如果硬件支持每个表面的颜色键,则为 DirectDrawSurface 对象设置颜色键值。
SetCooperativeLevel

确定应用程序的顶级行为。
SetDisplayMode

设置显示设备硬件的模式。
SetEntries

立即更改 DirectDrawPalette 对象中的条目。
SetGammaRamp

设置主表面的红色、绿色和蓝色伽玛坡度。
SetHWnd

设置剪辑器对象用于获取剪辑信息的窗口句柄。
SetLOD

设置托管 mipmap 图面 (LOD) 的最大详细级别。 此方法仅在托管纹理上成功。
SetOverlayPosition

更改覆盖图面的显示坐标。
SetPalette

将调色板对象附加到 (或从图面) 分离一个对象。 图面将此调色板用于所有后续操作。 调色板更改会立即发生,而不考虑刷新时间。
SetPriority

为此纹理分配纹理管理优先级。 此方法仅在托管纹理上成功。
SetPrivateData

将数据与应用程序(而不是 DirectDraw)要使用的图面相关联。 数据按值传递,多个数据集可以与单个图面相关联。
SetSurfaceDesc

设置现有图面的特征。
StartModeTest

启动测试以使用当前显示适配器和监视器组合的刷新率信息更新系统注册表。
TestCooperativeLevel

报告窗口或全屏应用程序的 DirectDraw 设备的当前协作级别状态。
Unlock

通知 DirectDraw 直接图面操作已完成。
UpdateOverlay

重新定位或修改覆盖图面的视觉属性。 这些图面必须设置DDSCAPS_OVERLAY标志。
UpdateOverlayDisplay

IDirectDrawSurface7::UpdateOverlayDisplay 方法当前未实现。
UpdateOverlayZOrder

设置覆盖的 z 顺序。
WaitForVerticalBlank

帮助应用程序将自身与垂直空白间隔同步。

接口

 
IDirectDraw7

应用程序使用 IDirectDraw7 接口的方法创建 DirectDraw 对象并使用系统级变量。 本部分是对 IDirectDraw7 接口方法的引用。
IDirectDrawClipper

应用程序使用 IDirectDrawClipper 接口的方法来管理剪辑列表。 本部分是对此接口方法的引用。
IDirectDrawColorControl

应用程序使用 IDirectDrawColorControl 接口的方法获取和设置颜色控件。
IDirectDrawGammaControl

应用程序使用 IDirectDrawGammaControl 接口的方法调整主图面的红色、绿色和蓝色伽玛渐变级别。 本部分是对此接口方法的引用。
IDirectDrawPalette

应用程序使用 IDirectDrawPalette 接口的方法来创建 DirectDrawPalette 对象,并使用系统级变量。 本部分是对此接口方法的引用。
IDirectDrawSurface7

应用程序使用 IDirectDrawSurface7 接口的方法创建 DirectDrawSurface 对象并使用系统级变量。 本部分是对此接口方法的引用。

结构

 
DDCOLORCONTROL

DDCOLORCONTROL 结构定义与 Microsoft DirectDraw 视频端口扩展关联的颜色控件, (VPE) 对象。
DDSURFACEDESC

DDSURFACEDESC 结构包含驱动程序要创建的图面的说明。
DDSURFACEDESC2

DDSURFACEDESC2 结构包含驱动程序要创建的图面的说明。
DDBLTBATCH

DDBLTBATCH 结构将位块传输 (bitblt) 操作传递到 IDirectDrawSurface7::BltBatch 方法。
DDBLTFX

DDBLTFX 结构将光栅操作 (RP) 、效果和替代信息传递给 IDirectDrawSurface7::Blt 方法。 此结构也是与 IDirectDrawSurface7::BltBatch 方法一起使用的 DDBLTBATCH 结构的一部分。
DDCAPS_DX3

ddraw.h) (DDCAPS_DX3结构表示通过 DirectDraw 对象公开的硬件的功能。
DDCAPS_DX5

ddraw.h) (DDCAPS_DX5 结构表示通过 DirectDraw 对象公开的硬件的功能。
DDCAPS_DX6

(ddraw.h) DDCAPS_DX6 结构表示通过 DirectDraw 对象公开的硬件的功能。
DDCAPS_DX7

ddraw.h) (DDCAPS_DX7 结构表示通过 DirectDraw 对象公开的硬件的功能。
DDCOLORKEY

DDCOLORKEY 结构描述源颜色键、目标颜色键或颜色空间。
DDDEVICEIDENTIFIER2

DDDEVICEIDENTIFIER2 结构将传递给 IDirectDraw7::GetDeviceIdentifier 方法,以获取有关设备的信息。
DDGAMMARAMP

DDGAMMARAMP 结构包含 IDirectDrawGammaControl::GetGammaRamp 和 IDirectDrawGammaControl::SetGammaRamp 方法的红色、绿色和蓝色渐变数据。
DDOVERLAYFX

DDOVERLAYFX 结构将覆盖信息传递给 IDirectDrawSurface7::UpdateOverlay 方法。
DDPIXELFORMAT

DDPIXELFORMAT 结构描述 IDirectDrawSurface7::GetPixelFormat 方法的 DirectDrawSurface 对象的像素格式。
DDSCAPS

DDSCAPS 结构定义 Microsoft DirectDraw Surface 对象的功能。
DDSCAPS2

DDSCAPS2 结构定义了 Microsoft DirectDraw Surface 对象的附加功能。