DD_NTPRIVATEDRIVERCAPS 结构 (ddrawint.h)

DD_NTPRIVATEDRIVERCAPS 结构使驱动程序能够在 DirectDraw 创建图面时更改 Microsoft DirectDraw 的行为。

语法

typedef struct DD_NTPRIVATEDRIVERCAPS {
  DWORD dwSize;
  DWORD dwPrivateCaps;
} DD_NTPRIVATEDRIVERCAPS;

成员

dwSize

指定此DD_NTPRIVATEDRIVERCAPS结构的大小(以字节为单位)。

dwPrivateCaps

指示 DirectDraw 应如何创建图面。

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

设置此标志时,它指示驱动程序仅当应用程序使用单个 CreateSurface 调用创建复杂的翻转链时请求调用 DdCreateSurface 一次。 在这种情况下,DD_CREATESURFACEDATA 结构的 lpSList 成员指向要创建 (的图面列表,而不是单个图面 ) ,dwSCnt 包含列表中的图面数。

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

设置此标志后,在创建主图面时将调用驱动程序的 DdCreateSurface 函数。 如果未设置此标志,则不调用驱动程序的 DdCreateSurface 函数。

注解

DirectDraw 的行为模拟了在为 Microsoft Windows 98/Me 创建图面时 DirectDraw 采用的图面创建技术。

如果未设置DDHAL_PRIVATECAP_AUTOMICSURFACECREATION标志,DirectDraw 将使用原始方法执行图面创建,即,对要创建的每个图面调用驱动程序的 DdCreateSurface 函数一次。

如果未设置DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION标志,DirectDraw 将使用原始方法执行主图面创建,即在创建主图面时不会调用驱动程序。

要求

要求
Header ddrawint.h (包括 Winddi.h)

另请参阅

DD_CREATESURFACEDATA

DdCreateSurface