(ddraw.h) IDirectDraw7 介面

應用程式會使用 IDirectDraw7 介面的 方法來建立 DirectDraw 物件，並使用系統層級變數。 本節是 IDirectDraw7 介面方法的參考。

繼承

IDirectDraw7介面繼承自IUnknown介面。 IDirectDraw7 也有下列類型的成員：

方法

IDirectDraw7介面具有這些方法。

IDirectDraw7：：Compact 這個方法目前尚未實作。 (IDirectDraw7.Compact)
IDirectDraw7：：CreateClipper 建立 DirectDrawClipper 物件。
IDirectDraw7：：CreatePalette 建立這個 DirectDraw 物件的 DirectDrawPalette 物件。
IDirectDraw7：：CreateSurface 建立這個 DirectDraw 物件的 DirectDrawSurface 物件。
IDirectDraw7：:D uplicateSurface 複製 DirectDrawSurface 物件。
IDirectDraw7：：EnumDisplayModes 列舉硬體透過 DirectDraw 物件公開且與所提供介面描述相容的所有顯示模式。
IDirectDraw7：：EnumSurfaces 列舉符合指定介面描述的所有現有或可能表面。
IDirectDraw7：：EvaluateMode 在呼叫 IDirectDraw7：：StartModeTest 之後使用，以通過或失敗測試呈現的每個模式，並逐步執行模式，直到測試完成為止。
IDirectDraw7：：FlipToGDISurface 讓 GDI 寫入主要表面的介面。
IDirectDraw7：：GetAvailableVidMem 擷取可用顯示記憶體的總數，以及目前可用的顯示記憶體數量，供指定類型的表面使用。
IDirectDraw7：：GetCaps 擷取硬體設備磁碟機的功能，以及硬體模擬層 (HEL) 。
IDirectDraw7：：GetDeviceIdentifier 取得設備磁碟機的相關資訊。 您可以使用這個方法，小心辨識特定的硬體安裝，以實作驅動程式或晶片組行為不佳的因應措施。
IDirectDraw7：：GetDisplayMode 擷取目前的顯示模式。
IDirectDraw7：：GetFourCCCodes 擷取 DirectDraw 物件支援的四個字元代碼 (FOURCC) 。 這個方法也可以擷取支援的程式碼數目。
IDirectDraw7：：GetGDISurface 擷取目前代表 GDI 視為主要表面之表面記憶體的 DirectDrawSurface 物件。
IDirectDraw7：：GetMonitorFrequency 擷取 DirectDraw 物件所控制之監視器的頻率。
IDirectDraw7：：GetScanLine 擷取目前正在監視器上繪製的掃描線條。
IDirectDraw7：：GetSurfaceFromDC 根據介面的 GDI 裝置內容控制碼，擷取表面的 IDirectDrawSurface7 介面。
IDirectDraw7：：GetVerticalBlankStatus 擷取垂直空白的狀態。
IDirectDraw7：：Initialize 初始化使用 CoCreateInstance COM 函式所建立的 DirectDraw 物件。
IDirectDraw7：：RestoreAllSurfaces 以建立 DirectDraw 物件的順序還原所有為 DirectDraw 物件建立的介面。
IDirectDraw7：：RestoreDisplayMode 將主要表面的顯示裝置硬體模式重設為呼叫 IDirectDraw7：：SetDisplayMode 方法之前的狀態。 需要獨佔層級存取才能使用這個方法。
IDirectDraw7：：SetCo，Level 決定應用程式的最上層行為。
IDirectDraw7：：SetDisplayMode 設定顯示裝置硬體的模式。
IDirectDraw7：：StartModeTest 起始測試，以使用目前顯示器介面卡和監視器組合的重新整理速率資訊來更新系統登錄。
IDirectDraw7：：TestCo，Level 報告適用于視窗式或全螢幕應用程式的 DirectDraw 裝置目前合作層級狀態。
IDirectDraw7：：WaitForVerticalBlank 協助應用程式與垂直空白間隔同步處理本身。

備註

IDirectDraw7介面的方法可以組織成下列群組：

群組	方法
配置記憶體	壓縮 和 初始化
合作層級	SetCovel 和 TestCo，Level
建立物件	CreateClipper、 CreatePalette和 CreateSurface
裝置功能	GetCaps
顯示模式	EnumDisplayModes、GetDisplayMode、GetMonitorFrequency、RestoreDisplayMode、SetDisplayMode和WaitForVerticalBlank
顯示狀態	GetScanLine 和 GetVerticalBlankStatus
其他	EvaluateMode、 GetAvailableVidMem、 GetDeviceIdentifier、 GetFourCCCodes和 StartModeTest
Surface 管理	DuplicateSurface、 EnumSurfaces、 FlipToGDISurface、 GetGDISurface、 GetSurfaceFromDC和 RestoreAllSurfaces

 

IDirectDraw7介面藉由提供比舊版更彈性介面管理的方法，擴充舊版介面的功能。 IDirectDraw7介面中的所有介面相關方法都接受與IDirectDraw2介面中對應專案稍有不同的參數。 只要 IDirectDraw2 介面方法可以接受 DDSURFACEDESC 結構並擷取 IDirectDrawSurface3 介面， IDirectDraw7 中的方法就會接受 DDSURFACEDESC2 結構，並改為擷取 IDirectDrawSurface7 介面。

IDirectDraw7 引進了改善的 COM 規則合規性，以決定子物件的存留期。

使用 LPDIRECTDRAW、LPDIRECTDRAW2、LPDIRECTDRAW4 或 LPDIRECTDRAW7 資料類型來宣告包含 IDirectDraw、 IDirectDraw2、 IDirectDraw4 或 IDirectDraw7 介面指標的變數。 Ddraw.h 標頭檔會使用下列程式碼宣告這些資料類型：

typedef struct IDirectDraw     FAR *LPDIRECTDRAW;
typedef struct IDirectDraw2    FAR *LPDIRECTDRAW2;
typedef struct IDirectDraw4    FAR *LPDIRECTDRAW4;
typedef struct IDirectDraw7    FAR *LPDIRECTDRAW7;

規格需求

目標平臺	Windows
標頭	ddraw.h