Share via


DD_NTPRIVATEDRIVERCAPS結構 (ddrawint.h)

DD_NTPRIVATEDRIVERCAPS 結構可讓驅動程式在建立 Surface 時變更 Microsoft DirectDraw 的行為。

語法

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

成員

dwSize

指定這個DD_NTPRIVATEDRIVERCAPS結構位元組的大小。

dwPrivateCaps

指出 DirectDraw 如何建立介面。

DDHAL_PRIVATECAP_AUTOMICSURFACECREATION

設定此旗標時,表示當應用程式使用單一 CreateSurface 呼叫建立複雜的翻轉鏈結時,驅動程式只會要求呼叫 DdCreateSurface。 在此情況下,DD_CREATESURFACEDATA 結構的 lplpSList 成員會指向要建立 ( 的介面清單,而不是單一表面) ,而 dwSCnt 包含清單中的表面數目。

DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION

設定此旗標時,會在建立主要介面時呼叫驅動程式的 DdCreateSurface 函式。 如果未設定此旗標,則不會呼叫驅動程式的 DdCreateSurface 函式。

備註

DirectDraw 的行為會模擬 DirectDraw 在建立 Microsoft Windows 98/Me 介面時所採用的介面建立技術。

未設定DDHAL_PRIVATECAP_AUTOMICSURFACECREATION旗標時,DirectDraw 會使用原始方法執行表面建立,也就是說,它會針對所建立的每個表面呼叫驅動程式的 DdCreateSurface 函式一次。

未設定DDHAL_PRIVATECAP_NOTIFYPRIMARYCREATION旗標時,DirectDraw 會使用原始方法執行主要介面建立,也就是說,它不會在建立主要介面時呼叫驅動程式。

規格需求

需求
標頭 ddrawint.h (包括 Winddi.h)

另請參閱

DD_CREATESURFACEDATA

DdCreateSurface