Platform SDK: DirectX

IDirectDrawSurface7

アプリケーションは IDirectDrawSurface7 インターフェイスのメソッドを使って、DirectDrawSurface オブジェクトを作成し、システムレベル変数と共に作用する。ここでは、このインターフェイスのメソッドのリファレンスを提供する。概念の概要については、「サーフェス」を参照すること。

IDirectDrawSurface7 インターフェイスのメソッドは、以下のグループにまとめることができる。

メモリの割り当て Initialize
  IsLost
Restore
サーフェスのアタッチ AddAttachedSurface
  DeleteAttachedSurface
EnumAttachedSurfaces
GetAttachedSurface
ブリット Blt
  BltBatch
BltFast
GetBltStatus
カラー キーイング GetColorKey
  SetColorKey
デバイス コンテキスト GetDC
  ReleaseDC
フリッピング Flip
  GetFlipStatus
サーフェスのロック Lock
  PageLock
PageUnlock
Unlock
その他 GetDDInterface
オーバーレイ AddOverlayDirtyRect
  EnumOverlayZOrders
GetOverlayPosition
SetOverlayPosition
UpdateOverlay
UpdateOverlayDisplay
UpdateOverlayZOrder
プライベート サーフェス データ FreePrivateData
  GetPrivateData
SetPrivateData
サーフェス能力 GetCaps
サーフェス クリッパー GetClipper
  SetClipper
サーフェス特性 ChangeUniquenessValue
  GetPixelFormat
GetSurfaceDesc
GetUniquenessValue
SetSurfaceDesc
サーフェス パレット GetPalette
  SetPalette
テクスチャ GetLOD
  GetPriority
SetLOD
SetPriority

すべての COM インターフェイスと同様、IDirectDrawSurface7 インターフェイスは IUnknown インターフェイス メソッドを継承する。IUnknown インターフェイスは、以下の 3 つのメソッドをサポートする。

IUnknown AddRef
  QueryInterface
Release

IDirectDrawSurface7 インターフェイスは、よりよいサーフェス管理と使いやすさを備えたメソッドを提供することにより、以前のバージョンのインターフェイス機能を拡張した。このインターフェイスの多くのメソッドは、以前のバージョンのインターフェイスで対応するメソッドとは若干異なるパラメータを受け取る。IDirectDrawSurface3 インターフェイス メソッドが DDSURFACEDESC 構造体や IDirectDrawSurface3 インターフェイスを受け取る場所は常に、代わりに IDirectDrawSurface7 のメソッドが DDSURFACEDESC2 構造体や IDirectDrawSurface7 インターフェイスを受け取る。

LPDIRECTDRAWSURFACELPDIRECTDRAWSURFACE2LPDIRECTDRAWSURFACE3LPDIRECTDRAWSURFACE4LPDIRECTDRAWSURFACE7 データ型を使用すると、さまざまな DirectDrawSurface オブジェクト インターフェイスを指す変数を宣言できる。ddraw.h ヘッダー ファイルは、以下のコードでこれらのデータ型を宣言する。

typedef struct IDirectDrawSurface     FAR *LPDIRECTDRAWSURFACE;
typedef struct IDirectDrawSurface2    FAR *LPDIRECTDRAWSURFACE2;
typedef struct IDirectDrawSurface3    FAR *LPDIRECTDRAWSURFACE3;
typedef struct IDirectDrawSurface4    FAR *LPDIRECTDRAWSURFACE4;
typedef struct IDirectDrawSurface7    FAR *LPDIRECTDRAWSURFACE7;

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。