Platform SDK: DirectX

戻り値

エラーは負の値で表され、組み合わされることはない。このテーブルは、IDirectDraw7IDirectDrawSurface7IDirectDrawPaletteIDirectDrawClipperIDDVideoPortContainer、および 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
提供された矩形を必要とされる範囲に水平一列に並べることができなかった。