戻り値
エラーは負の値で表され、組み合わされることはない。このテーブルは、IDirectDraw7、IDirectDrawSurface7、IDirectDrawPalette、IDirectDrawClipper、IDDVideoPortContainer、および IDirectDrawVideoPort インターフェイスのすべてのメソッドにより返される可能性のある値を一覧表示している。個々のメソッドが返す可能性のあるエラー コードのリストは、そのメソッドの記述を参照すること。
- DD_OK
- 要求は成功し完了した。
- DDERR_ALREADYINITIALIZED
- オブジェクトは既に初期化されている。
- DDERR_BLTFASTCANTCLIP
- DirectDrawClipper オブジェクトは、IDirectDrawSurface7::BltFast メソッドの呼び出しに渡された転送元サーフェスにアタッチされている。
- DDERR_CANNOTATTACHSURFACE
- 要求されたサーフェスにはサーフェスをアタッチできない。
- DDERR_CANNOTDETACHSURFACE
- 要求されたサーフェスからサーフェスのアタッチを解除できない。
- DDERR_CANTCREATEDC
- Windows はこれ以上デバイス コンテキスト (DC) を作成できない。また、サーフェスにパレットがなく、ディスプレイ モードがインデック付きのパレットでない場合に、DC がインデックス付きパレット サーフェスを要求した (この場合、DirectDraw は DC に適切なパレットを選択できない)。
- DDERR_CANTDUPLICATE
- プライマリ サーフェス、3D サーフェス、暗に作られるサーフェスは複製できない。
- DDERR_CANTLOCKSURFACE
- DCI サポートなしでプライマリ サーフェスをロックしようとしたため、このサーフェスへのアクセスが拒否された。
- DDERR_CANTPAGELOCK
- サーフェスのページロックが失敗した。ページ ロックは、ディスプレイメモリ サーフェスまたはエミュレートされたプライマリ サーフェスでは作用しない。
- DDERR_CANTPAGEUNLOCK
- サーフェスのページロックの解除が失敗した。ページ ロックの解除は、ディスプレイメモリ サーフェスまたはエミュレートされたプライマリ サーフェスでは作用しない。
- DDERR_CLIPPERISUSINGHWND
- ウィンドウ ハンドルを既に監視している DirectDrawClipper オブジェクトに対して、クリップ リストを設定しようとした。
- DDERR_COLORKEYNOTSET
- この処理に対して、転送元カラー キーが指定されていない。
- DDERR_CURRENTLYNOTAVAIL
- 現時点ではサポートされていない。
- DDERR_DDSCAPSCOMPLEXREQUIRED
- DirectX 7.0 で追加。サーフェスが DDSCAPS_COMPLEX フラグを要求している。
- DDERR_DCALREADYCREATED
- デバイス コンテキスト (DC) は既にこのサーフェスに対して返されている。1 サーフェスにつき 1 つの DC しか取得することはできない。
- DDERR_DEVICEDOESNTOWNSURFACE
- 1 つの DirectDraw デバイスで作成されたサーフェスは、別の DirectDraw デバイスで直接使用することはできない。
- DDERR_DIRECTDRAWALREADYCREATED
- このドライバを表す DirectDraw オブジェクトが、このプロセスで既に作成されていることを表す。
- DDERR_EXCEPTION
- 要求された処理を実行する間に例外が発生した。
- DDERR_EXCLUSIVEMODEALREADYSET
- 既に排他モードが設定されているにもかかわらず、協調レベルを設定しようとした。
- DDERR_EXPIRED
- データが終了したので、有効でなくなった。
- DDERR_GENERIC
- 未定義のエラー状態である。
- DDERR_HEIGHTALIGN
- 提供された矩形の高さは、必要とされるアライメントの倍数ではない。
- DDERR_HWNDALREADYSET
- DirectDraw 協調レベル ウィンドウ ハンドルが既に設定されている。ウィンドウ ハンドルは、プロセスがサーフェスあるいは作成されたパレットを保持している間はリセットできない。
- DDERR_HWNDSUBCLASSED
- DirectDraw 協調レベル ウィンドウ ハンドルがサブクラス化されているため、DirectDraw の状態のリストアが阻止された。
- DDERR_IMPLICITLYCREATED
- サーフェスが暗に作成されたために、サーフェスをリストアできない。
- DDERR_INCOMPATIBLEPRIMARY
- プライマリ サーフェスの作成要求が既存のプライマリ サーフェスと一致していない。
- DDERR_INVALIDCAPS
- コールバック関数に渡された 1 つ以上の能力ビットが不正である。
- DDERR_INVALIDCLIPLIST
- DirectDraw は、提供されたクリップ リストをサポートしない。
- DDERR_INVALIDDIRECTDRAWGUID
- DirectDrawCreate 関数に渡されるグローバル ユニーク識別子 (GUID) が有効な DirectDraw ドライバ識別子でない。
- DDERR_INVALIDMODE
- DirectDraw は要求されたモードをサポートしない。
- DDERR_INVALIDOBJECT
- DirectDraw が、無効な DirectDraw オブジェクトのポインタを受け取った。
- DDERR_INVALIDPARAMS
- メソッドに渡された 1 つ以上のパラメータが不正である。
- DDERR_INVALIDPIXELFORMAT
- 指定されたピクセル フォーマットが無効である。
- DDERR_INVALIDPOSITION
- 転送先のオーバーレイの位置が不正である。
- DDERR_INVALIDRECT
- 提供された矩形が無効である。
- DDERR_INVALIDSTREAM
- 指定されたストリームに無効なデータを含む。
- DDERR_INVALIDSURFACETYPE
- サーフェスの種類が間違っている。
- DDERR_LOCKEDSURFACES
- 1 つ以上のサーフェスがロックされており、要求された処理に失敗した。
- DDERR_MOREDATA
- 指定されたバッファ サイズに保持できる以上のデータが存在する。
- DDERR_NEWMODE
- DirectX 7.0 で追加。DDSMT_ISTESTREQUIRED フラグで IDirectDraw7::StartModeTest を呼び出すと、解像度の一部またはすべてをテストできる、あるいはテストする必要があることを示すこの値が返される。IDirectDraw7::EvaluateMode は、テストが新しいディスプレイ モードに切り替わったことを示すこの値を返す。
- DDERR_NO3D
- 3-D ハードウェアまたはエミュレーションが存在しない。
- DDERR_NOALPHAHW
- アルファアクセラレート ハードウェアが存在しないか利用できなかったため、要求された処理に失敗した。
- DDERR_NOBLTHW
- ブリット ハードウェアが存在しない。
- DDERR_NOCLIPLIST
- 利用可能なクリップ リストがない。
- DDERR_NOCLIPPERATTACHED
- DirectDrawClipper オブジェクトがサーフェス オブジェクトにアタッチできない。
- DDERR_NOCOLORCONVHW
- 色変換ハードウェアが存在しない、または利用できない。
- DDERR_NOCOLORKEY
- サーフェスに現在のカラー キーがない。
- DDERR_NOCOLORKEYHW
- 転送先カラー キーに対するハードウェア サポートがない。
- DDERR_NOCOOPERATIVELEVELSET
- IDirectDraw7::SetCooperativeLevel メソッドを使用せずに作成関数が呼び出された。
- DDERR_NODC
- このサーフェスに対して、デバイス コンテキスト (DC) が作成されていない。
- DDERR_NODDROPSHW
- DirectDraw ラスタ処理 (ROP) ハードウェアが利用できない。
- DDERR_NODIRECTDRAWHW
- ハードウェア専用 DirectDraw オブジェクトを作成できない。ドライバはハードウェアをサポートしない。
- DDERR_NODIRECTDRAWSUPPORT
- 現在のディスプレイ ドライバは DirectDraw をサポートしない。
- DDERR_NODRIVERSUPPORT
- DirectX 7.0 で追加。ディスプレイ アダプタ ドライバがリフレッシュ レートを列挙しないため、テストを実行できない。
- DDERR_NOEMULATION
- ソフトウェア エミュレーションが利用できない。
- DDERR_NOEXCLUSIVEMODE
- アプリケーションに対して排他モードが要求されたが、アプリケーションには排他モードがない。
- DDERR_NOFLIPHW
- 表示されるサーフェスをフリッピングできない。
- DDERR_NOFOCUSWINDOW
- 最初にフォーカス ウィンドウを設定せずにデバイス ウィンドウを設定または作成しようとした。
- DDERR_NOGDI
- GDI が存在しない。
- DDERR_NOHWND
- クリッパー通知がウィンドウ ハンドルを必要とする、あるいはウィンドウ ハンドルが協調レベル ウィンドウ ハンドルとしてあらかじめ設定されていない。
- DDERR_NOMIPMAPHW
- ミップマップ能力を持つテクスチャ マッピング ハードウェアが存在しない、または利用できない。
- DDERR_NOMIRRORHW
- ミラーリング ハードウェアが存在しない、または利用できない。
- DDERR_NOMONITORINFORMATION
- DirectX 7.0 で追加。関連付けられた EDID データがモニタに存在しないため、テストを実行できない。
- DDERR_NONONLOCALVIDMEM
- 非ローカル ビデオ メモリをサポートしないデバイスから、非ローカル ビデオ メモリを割り当てようとした。
- DDERR_NOOPTIMIZEHW
- デバイスは、最適化されたサーフェスをサポートしない。
- DDERR_NOOVERLAYDEST
- 転送先として確立するために IDirectDrawSurface7::UpdateOverlay メソッドが呼び出されなかったオーバーレイにおいて、IDirectDrawSurface7::GetOverlayPosition メソッドが呼び出されている。
- DDERR_NOOVERLAYHW
- オーバーレイ ハードウェアが存在しない、または利用できない。
- DDERR_NOPALETTEATTACHED
- パレット オブジェクトをこのサーフェスにアタッチできない。
- DDERR_NOPALETTEHW
- 16 色あるいは 256 色のパレットに対するハードウェア サポートがない。
- DDERR_NORASTEROPHW
- 適切なラスタ処理ハードウェアが存在しない、または利用できない。
- DDERR_NOROTATIONHW
- 回転ハードウェアが存在しない、または利用できない。
- DDERR_NOSTEREOHARDWARE
- ステレオ ハードウェアが存在しない、または利用できない。
- DDERR_NOSTRETCHHW
- 伸縮に対するハードウェア サポートがない。
- DDERR_NOSURFACELEFT
- ステレオ サーフェスをサポートするハードウェアが存在しない。
- DDERR_NOT4BITCOLOR
- DirectDrawSurface オブジェクトは、4 ビット色パレットを使用していない。また、要求された処理は 4 ビット色パレットを要求する。
- DDERR_NOT4BITCOLORINDEX
- DirectDrawSurface オブジェクトは、4 ビット カラー インデックス パレットを使用していない。また、要求された処理は 4 ビット カラー インデックス パレットを要求する。
- DDERR_NOT8BITCOLOR
- DirectDrawSurface オブジェクトは、8 ビット色パレットを使用していない。また、要求された処理は 8 ビット色パレットを要求する。
- DDERR_NOTAOVERLAYSURFACE
- 非オーバーレイ サーフェスに対して、オーバーレイ成分が呼び出されている。
- DDERR_NOTEXTUREHW
- テクスチャマッピング ハードウェアが存在しないか利用できないため、処理を実行できない。
- DDERR_NOTFLIPPABLE
- フリップできないサーフェスをフリップしようとした。
- DDERR_NOTFOUND
- 要求された項目が見つからなかった。
- DDERR_NOTINITIALIZED
- オブジェクトが初期化される前に、CoCreateInstance で作成した DirectDraw オブジェクトのインターフェイス メソッドを呼び出そうとした。
- DDERR_NOTLOADED
- サーフェスは最適化されているが、まだメモリが割り当てられていない。
- DDERR_NOTLOCKED
- ロックされていないサーフェスをロック解除しようとした。
- DDERR_NOTPAGELOCKED
- 未処理のページ ロックがないサーフェスをページ ロック解除しようとした。
- DDERR_NOTPALETTIZED
- 使用しているサーフェスはパレットベースのサーフェスではない。
- DDERR_NOVSYNCHW
- 垂直帰線消去同期処理に対するハードウェア サポートがない。
- DDERR_NOZBUFFERHW
- Z バッファに対するハードウェア サポートがないため、ディスプレイ メモリでの Z バッファ作成、あるいは Z バッファを使用したブリットが実行できない。
- DDERR_NOZOVERLAYHW
- オーバーレイ サーフェスは、ハードウェアがオーバーレイ z オーダーをサポートしないため、z オーダーが無視された。
- DDERR_OUTOFCAPS
- 要求された処理に必要なハードウェアが既に割り当てられている。
- DDERR_OUTOFMEMORY
- DirectDraw が処理を行うのに十分なメモリがない。
- DDERR_OUTOFVIDEOMEMORY
- DirectDraw が処理を行うのに十分なディスプレイ メモリがない。
- DDERR_OVERLAPPINGRECTS
- 転送元および転送先矩形が同じサーフェス上にあり、互いにオーバーラップしている。
- DDERR_OVERLAYCANTCLIP
- ハードウェアはクリッピング オーバーレイをサポートしない。
- DDERR_OVERLAYCOLORKEYONLYONEACTIVE
- オーバーレイ上に複数のアクティブなカラー キーを持とうとした。
- DDERR_OVERLAYNOTVISIBLE
- IDirectDrawSurface7::GetOverlayPosition メソッドが非表示のオーバーレイで呼び出された。
- DDERR_PALETTEBUSY
- パレットがもう 1 つのスレッドによりロックされているため、アクセスが拒否された。
- DDERR_PRIMARYSURFACEALREADYEXISTS
- この処理は既にプライマリ サーフェスを作成している。
- DDERR_REGIONTOOSMALL
- IDirectDrawClipper::GetClipList メソッドに渡された領域が小さすぎる。
- DDERR_SURFACEALREADYATTACHED
- 既にアタッチしているもう 1 つのサーフェスにサーフェスをアタッチしようとした。
- DDERR_SURFACEALREADYDEPENDENT
- 既にほかのサーフェスに依存しているサーフェスを依存させようとした。
- DDERR_SURFACEBUSY
- サーフェスがもう 1 つのスレッドでロックされているため、サーフェスへのアクセスが拒否された。
- DDERR_SURFACEISOBSCURED
- サーフェスへのアクセスが、サーフェスが隠蔽されているため拒否された。
- DDERR_SURFACELOST
- サーフェス メモリの不足のため、サーフェスへのアクセスが拒否された。このサーフェスで IDirectDrawSurface7::Restore メソッドを呼び出すと、関連付けられたメモリをリストアできる。
- DDERR_SURFACENOTATTACHED
- 要求されたサーフェスはアタッチできない。
- DDERR_TESTFINISHED
- DirectX 7.0 で追加。IDirectDraw7::StartModeTest メソッドがこの値を返した場合、テスト用に選択したすべての解像度は既にリフレッシュ レート情報をレジストリに持っているため、テストを開始できないことを意味する。IDirectDraw7::EvaluateMode メソッドがこの値を返した場合は、DirectDraw がリフレッシュ レート テストを完了したことを意味する。
- DDERR_TOOBIGHEIGHT
- DirectDraw で要求された幅が大きすぎる。
- DDERR_TOOBIGSIZE
- DirectDraw で要求されたサイズが大きすぎる。ただし、個々の高さおよび幅は有効なサイズである。
- DDERR_TOOBIGWIDTH
- DirectDraw によって要求された幅が大きすぎる。
- DDERR_UNSUPPORTED
- サポートされない処理であった。
- DDERR_UNSUPPORTEDFORMAT
- 要求されたピクセル フォーマットは DirectDraw ではサポートされていない。
- DDERR_UNSUPPORTEDMASK
- 要求されたピクセル フォーマットのビットマスクが DirectDraw でサポートされていない。
- DDERR_UNSUPPORTEDMODE
- ディスプレイは現在サポートされていないモードである。
- DDERR_VERTICALBLANKINPROGRESS
- 垂直帰線消去期間である。
- DDERR_VIDEONOTACTIVE
- ビデオ ポートがアクティブではない。
- DDERR_WASSTILLDRAWING
- このサーフェスから、またはサーフェスへの前回のブリット処理が完了していない。
- DDERR_WRONGMODE
- 異なったモードで作成されたため、このサーフェスはリストアすることができない。
- DDERR_XALIGN
- 提供された矩形を必要とされる範囲に水平一列に並べることができなかった。