戻り値
エラーは、負の値で表されるので、組み合わせることができない。この表は、すべての Direct3D 直接モード メソッドが返すことのできる値をまとめたものである。各メソッドが返す値の一覧については、各メソッドについての説明を参照すること。
- D3D_OK
- エラーは発生していない。
- D3DERR_BADMAJORVERSION
- 要求したサービスはこの主要バージョンの DirectX では使用できない (主要バージョンとは DirectX 6.0 などの主要リリースのことである)。
- D3DERR_BADMINORVERSION
- 要求したサービスはこの主要バージョンの DirectX で使用可能であるが、このマイナー バージョンでは使用できない。Microsoft から最新のコンポーネント ランタイムを入手すること (マイナー バージョンとは Direct 6.1 などのセカンダリ リリースのことである)。
- D3DERR_COLORKEYATTACHED
- アプリケーションが透過用カラー キーを使用するサーフェスでテクスチャを作成しようとした。
- D3DERR_CONFLICTINGTEXTUREFILTER
- 現在のテクスチャ フィルタは一緒に使用できない。
- D3DERR_CONFLICTINGTEXTUREPALETTE
- 現在のテクスチャは同時に使用できない。一般にマルチテクスチャ デバイスにおいて、同時に有効にされたパレット化テクスチャで同じパレットを共有する必要がある場合に発生する。
- D3DERR_CONFLICTINGRENDERSTATE
- 現在設定されているレンダリング ステートは一緒に使用できない。
- D3DERR_DEVICEAGGREGATED
- IDirect3DDevice7::SetRenderTarget メソッドが、レンダリング ターゲット サーフェスから取得されたデバイスで呼び出された。
- D3DERR_EXECUTE_CLIPPED_FAILED
- 実行中に実行バッファをクリッピングできなかった。
- D3DERR_EXECUTE_CREATE_FAILED
- 実行バッファを作成できなかった。一般に実行バッファに割り当てるメモリが不足している場合に発生する。
- D3DERR_EXECUTE_DESTROY_FAILED
- 実行バッファ用のメモリの割り当てを解除できなかった。
- D3DERR_EXECUTE_FAILED
- 実行バッファの内容が無効であるため実行できない。
- D3DERR_EXECUTE_LOCK_FAILED
- 実行バッファをロックできなかった。
- D3DERR_EXECUTE_LOCKED
- 実行バッファがロックされているため、アプリケーションから要求した処理を完了できなかった。
- D3DERR_EXECUTE_NOT_LOCKED
- 実行バッファは現在ロックされていないため、実行バッファをロック解除できなかった。
- D3DERR_EXECUTE_UNLOCK_FAILED
- 実行バッファをロック解除できなかった。
- D3DERR_INBEGIN
- シーンのレンダリング中であるため、要求された処理が実行できない。シーンが完了してから IDirect3DDevice7::EndScene メソッドを呼び出した後、再度試してみる。
- D3DERR_INBEGINSTATEBLOCK
- ステート ブロックの記録中であるため、処理が実行できない。IDirect3DDevice7::EndStateBlock メソッドを呼び出してレコーディングを完了した後、再度試してみる。
- D3DERR_INITFAILED
- 新しいデバイスを初期化できなかったため、レンダリング デバイスを作成できなかった。
- D3DERR_INVALID_DEVICE
- 要求されたデバイスの種類が有効でない。
- D3DERR_INVALIDCURRENTVIEWPORT
- 現在選択されているビューポートが有効でない。
- D3DERR_INVALIDMATRIX
- 現在設定されているワールド行列、ビュー行列、または射影行列の組み合わせが無効であるため (行列を組み合わせた結果、行列式が 0 になる)、要求された処理を実行できなかった。
- D3DERR_INVALIDPALETTE
- サーフェスに関連付けられているパレットが無効である。
- D3DERR_INVALIDPRIMITIVETYPE
- アプリケーションで指定したプリミティブの種類が無効である。
- D3DERR_INVALIDRAMPTEXTURE
- ランプ モードが使われ、現在のマテリアルのテクスチャ ハンドルは、レンダリング ステートとして設定された現在のテクスチャ ハンドルに適合しない。
- D3DERR_INVALIDSTATEBLOCK
- ステート ブロック ハンドルが無効である。
- D3DERR_INVALIDVERTEXFORMAT
- アプリケーションで指定した柔軟な頂点フォーマット フラグの組み合わせが有効でない。
- D3DERR_INVALIDVERTEXTYPE
- アプリケーションで指定した頂点の種類が無効である。
- D3DERR_LIGHT_SET_FAILED
- ライティング オブジェクへのライティング パラメータの設定が失敗した。
- D3DERR_LIGHTHASVIEWPORT
- ライティング オブジェクトが別のビューポートに関連付けられているため、要求された処理が失敗した。
- D3DERR_LIGHTNOTINTHISVIEWPORT
- ライティング オブジェクトがこのビューポートに関連付けられていないため、要求された処理が失敗した。
- D3DERR_MATERIAL_CREATE_FAILED
- マテリアルを作成できなかった。一般にマテリアルに割り当てるメモリが不足している場合に発生する。
- D3DERR_MATERIAL_DESTROY_FAILED
- マテリアル用のメモリの割り当てを解除できなかった。
- D3DERR_MATERIAL_GETDATA_FAILED
- マテリアル パラメータを取得できなかった。
- D3DERR_MATERIAL_SETDATA_FAILED
- マテリアル パラメータを設定できなかった。
- D3DERR_MATRIX_CREATE_FAILED
- 行列を作成できなかった。行列に割り当てるメモリが不足している場合に発生する。
- D3DERR_MATRIX_DESTROY_FAILED
- 行列用のメモリの割り当てを解除できなかった。
- D3DERR_MATRIX_GETDATA_FAILED
- 行列データを取得できなかった。行列が現在のデバイスで作成されていない場合に発生する。
- D3DERR_MATRIX_SETDATA_FAILED
- 行列データを設定できなかった。行列が現在のデバイスで作成されていない場合に発生する。
- D3DERR_NOCURRENTVIEWPORT
- ビューポート パラメータが設定されていないため取得できなかった。
- D3DERR_NOTINBEGIN
- シーンのレンダリングが開始していないため、要求されたレンダリング処理を完了できなかった。IDirect3DDevice7::BeginScene を呼び出してレンダリングを開始し、再度試してみる。
- D3DERR_NOTINBEGINSTATEBLOCK
- 要求された処理はステート ブロックの記録中にのみ有効であるため、その処理を完了できなかった。IDirect3DDevice7::BeginStateBlock メソッドを呼び出して再度試してみる。
- D3DERR_NOVIEWPORTS
- 現在デバイスにはビューポートが関連付けられていないため、要求された処理が失敗した。
- D3DERR_SCENE_BEGIN_FAILED
- シーンのレンダリングが開始できなかった。
- D3DERR_SCENE_END_FAILED
- シーンのレンダリングを完了できなかった。
- D3DERR_SCENE_IN_SCENE
- IDirect3DDevice7::EndScene メソッドの呼び出しによって前回のシーンが完了していないため、シーンのレンダリングが開始できなかった。
- D3DERR_SCENE_NOT_IN_SCENE
- 前の IDirect3DDevice7::BeginScene メソッドの呼び出しによってシーンが開始していないため、シーンのレンダリングを完了できなかった。
- D3DERR_SETVIEWPORTDATA_FAILED
- ビューポート パラメータを設定できなかった。
- D3DERR_STENCILBUFFER_NOTPRESENT
- レンダリング ターゲット サーフェスにステンシル バッファがアタッチしていないため、要求されたステンシル バッファ処理を完了できなかった。
- D3DERR_SURFACENOTINVIDMEM
- レンダリング ターゲット サーフェスがビデオ メモリ内に見つからないため、デバイスを作成できなかった (ハードウェア アクセラレーション デバイスには、ビデオ メモリ内のレンダリング ターゲット サーフェスが必要である)。
- D3DERR_TEXTURE_BADSIZE
- 現在のテクスチャの大きさが無効である。2 の累乗の大きさを持つテクスチャが必要なデバイスで、それ以外の大きさのテクスチャを使用しようとした場合に発生する。
- D3DERR_TEXTURE_CREATE_FAILED
- ドライバからテクスチャのテクスチャ ハンドルを取得できなかった。
- D3DERR_TEXTURE_DESTROY_FAILED
- デバイスがテクスチャ メモリの割り当てを解除できなかった。
- D3DERR_TEXTURE_GETSURF_FAILED
- テクスチャ作成に使用する DirectDraw サーフェスを取得できなかった。
- D3DERR_TEXTURE_LOAD_FAILED
- テクスチャをロードできなかった。
- D3DERR_TEXTURE_LOCK_FAILED
- テクスチャをロックできなかった。
- D3DERR_TEXTURE_LOCKED
- テクスチャ サーフェスが現在ロックされているため、要求された処理を完了できなかった。
- D3DERR_TEXTURE_NO_SUPPORT
- デバイスがテクスチャ マッピングをサポートしていない。
- D3DERR_TEXTURE_NOT_LOCKED
- テクスチャ サーフェスがロックされていないため、要求された処理を完了できなかった。
- D3DERR_TEXTURE_SWAP_FAILED
- テクスチャ ハンドルをスワップできなかった。
- D3DERR_TEXTURE_UNLOCK_FAILED
- テクスチャ サーフェスをロック解除できなかった。
- D3DERR_TOOMANYOPERATIONS
- アプリケーションで、デバイス サポート以上のテクスチャフィルタリング処理を要求している。
- D3DERR_TOOMANYPRIMITIVES
- デバイスは、1 回だけの受け渡しでは指定された個数のプリミティブをレンダリングできない。
- D3DERR_UNSUPPORTEDALPHAARG
- アルファ チャネルに指定されたテクスチャブレンディング引数のうち、デバイスでサポートしていない引数がある。
- D3DERR_UNSUPPORTEDALPHAOPERATION
- アルファ チャネルに指定されたテクスチャブレンディング処理のうち、デバイスでサポートしていない処理がある。
- D3DERR_UNSUPPORTEDCOLORARG
- カラー値に指定されたテクスチャブレンディング引数のうち、デバイスでサポートしていない引数がある。
- D3DERR_UNSUPPORTEDCOLOROPERATION
- カラー値に指定されたテクスチャブレンディング処理のうち、デバイスでサポートしていない処理がある。
- D3DERR_UNSUPPORTEDFACTORVALUE
- 指定されたテクスチャ係数値がデバイスでサポートされていない。
- D3DERR_UNSUPPORTEDTEXTUREFILTER
- 指定されたテクスチャ フィルタがデバイスでサポートされていない。
- D3DERR_VBUF_CREATE_FAILED
- 頂点バッファを作成できなかった。頂点バッファを割り当てるのに十分なメモリがない場合に発生する。
- D3DERR_VERTEXBUFFERLOCKED
- 頂点バッファがロックされているため、要求された処理を完了できなかった。
- D3DERR_VERTEXBUFFEROPTIMIZED
- 頂点バッファが最適化されているため、要求された処理を完了できなかった (最適化された頂点バッファの内容は、ドライバ固有でプライベートと見なされる)。
- D3DERR_VERTEXBUFFERUNLOCKFAILED
- 頂点バッファ メモリがオーバランしたため、頂点バッファをロック解除できなかった。アプリケーションで頂点バッファのサイズ以上の書き込みを実行しないように注意すること。
- D3DERR_VIEWPORTDATANOTSET
- ビューポート パラメータが未設定であるため、要求された処理を完了できなかった。IDirect3DDevice7::SetViewport メソッドを呼び出してビューポート パラメータを設定し、再度試してみる。
- D3DERR_VIEWPORTHASNODEVICE
- この値は IDirect3DDevice3 およびそれ以前のインターフェイスでのみ使用される。IDirect3DDevice7 インターフェイスでは、このエラー値は使用されない。
ビューポートがデバイスに関連付けられていないため、要求された処理を完了できなかった。IDirect3DDevice3::AddViewport メソッドを呼び出してビューポートをレンダリング デバイスに関連付けて、再度試してみる。
- D3DERR_WRONGTEXTUREFORMAT
- テクスチャ サーフェスのピクセル フォーマットが有効でない。
- D3DERR_ZBUFF_NEEDS_SYSTEMMEMORY
- 指定されたデバイスではシステムメモリの深度バッファ サーフェスが必要なため、要求された処理を完了できなかった (ソフトウェア レンダリング デバイスでは、システムメモリの深度バッファが必要である)。
- D3DERR_ZBUFF_NEEDS_VIDEOMEMORY
- 指定されたデバイスではビデオ メモリの深度バッファ サーフェスが必要なため、要求された処理を完了できなかった (ハードウェア アクセラレーション デバイスでは、ビデオメモリの深度バッファが必要である)。
- D3DERR_ZBUFFER_NOTPRESENT
- レンダリング ターゲット サーフェスにアタッチされた深度バッファがないため、要求された処理を完了できなかった。