Platform SDK: DirectX |
DirectDrawCreateEx 関数は、最新の Direct3D インターフェイス セットをサポートする DirectDraw オブジェクトのインスタンスを作成する。DirectX 7.0 で Direct3D の新機能を使用するには、この関数で DirectDraw オブジェクトを作成する。DirectDraw および Direct3D 間の関係の詳細については、「DirectDraw オブジェクトと Direct3D」および「Direct3D へのアクセス」を参照すること。
HRESULT WINAPI DirectDrawCreateEx( GUID FAR *lpGUID, LPVOID *lplpDD, REFIID iid, IUnknown FAR *pUnkOuter );
成功すれば、DD_OK を返す。
失敗すれば、以下のエラー値のいずれかを返す。
DDERR_DIRECTDRAWALREADYCREATED |
DDERR_GENERIC |
DDERR_INVALIDDIRECTDRAWGUID |
DDERR_INVALIDPARAMS |
DDERR_NODIRECTDRAWHW |
DDERR_OUTOFMEMORY |
この関数は、DirectDraw オブジェクトを初期化しようとする。呼び出しが成功すると、オブジェクトへのポインタを設定する。
マルチ モニタのシステムで lpGUID に NULL を指定すると、標準協調レベルが設定されている場合に、DirectDraw オブジェクトはエミュレーション モードで実行する。これらのシステムでハードウェア アクセラレータを使用するには、デバイスの GUID を指定する。詳細については、「MultiMon システムのデバイスとアクセラレータ」を参照すること。
Windows NT/2000 :Windows 2000 が必要。
Windows 95/98 : Windows 98 が必要。
ヘッダー : ddraw.h で宣言。
インポート ライブラリ : ddraw.lib を使用。