Platform SDK: DirectX

IDirectDrawSurface7::GetDC

IDirectDrawSurface7::GetDC メソッドは、サーフェスに対するデバイス コンテキストの GDI 互換ハンドルを作成する。

HRESULT GetDC(
  HDC FAR *lphDC  
);

パラメータ

lphDC
返される、デバイス コンテキストのハンドルのアドレス。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_DCALREADYCREATED
DDERR_GENERIC
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_INVALIDSURFACETYPE
DDERR_SURFACELOST
DDERR_UNSUPPORTED
DDERR_WASSTILLDRAWING

注意

このメソッドは、サーフェスをロックする IDirectDrawSurface7::Lock メソッドの内部バージョンを使用する。IDirectDrawSurface7::ReleaseDC メソッドが呼び出されるまでは、サーフェスはロックされたままである。

ReleaseDC は、GetDC を呼び出す同じスレッドから呼び出す必要がある。

動作環境

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

参照

IDirectDrawSurface7::Lock