DXGI_ERROR

  • [アーティクル]

DXGI 関数によって返されるエラー コード。

定数/値 説明
DXGI_ERROR_ACCESS_DENIED
0x887A002B
 必要なアクセス特権がないリソースを使用しようとしました。 このエラーは、読み取り専用アクセス権を持つ共有リソースに書き込む場合に最も一般的に発生します。
DXGI_ERROR_ACCESS_LOST
0x887A0026
 デスクトップ重複インターフェイスが無効です。 デスクトップの複製インターフェイスは、通常、別の種類のイメージがデスクトップに表示されると無効になります。
DXGI_ERROR_ALREADY_EXISTS
0x887A0036L
 目的の要素は既に存在します。 これは、関数が初めて呼び出されない場合、 DXGIDeclareAdapterRemovalSupport によって返されます。
DXGI_ERROR_CANNOT_PROTECT_CONTENT
0x887A002A
 DXGI では、スワップ チェーンにコンテンツ保護を提供できません。 このエラーは通常、古いドライバーが原因で発生するか、コンテンツ保護と互換性のないスワップ チェーンを使用する場合に発生します。
DXGI_ERROR_DEVICE_HUNG
0x887A0006
 アプリケーションから送信された不適切な形式のコマンドが原因で、アプリケーションのデバイスが失敗しました。 これは、調査して修正する必要があるデザイン時の問題です。
DXGI_ERROR_DEVICE_REMOVED
0x887A0005
 ビデオ カードがシステムから物理的に削除されたか、ビデオ カードのドライバーのアップグレードが発生しました。 アプリケーションはデバイスを破棄して再作成する必要があります。 問題のデバッグについては、 ID3D10Device::GetDeviceRemovedReason を呼び出してください。
DXGI_ERROR_DEVICE_RESET
0x887A0007
 不適切な形式のコマンドが原因でデバイスが失敗しました。 これは実行時の問題です。アプリケーションはデバイスを破棄して再作成する必要があります。
DXGI_ERROR_DRIVER_INTERNAL_ERROR
0x887A0020
 ドライバーで問題が発生し、デバイスが削除された状態になりました。
DXGI_ERROR_FRAME_STATISTICS_DISJOINT
0x887A000B
 イベント (電源サイクルなど) によって、プレゼンテーション統計の収集が中断されました。
DXGI_ERROR_GRAPHICS_VIDPN_SOURCE_IN_USE
0x887A000C
 アプリケーションは出力の排他的所有権を取得しようとしましたが、他のアプリケーション (またはアプリケーション内のデバイス) が既に所有権を取得しているため、失敗しました。
DXGI_ERROR_INVALID_CALL
0x887A0001
 アプリケーションが無効なパラメーター データを提供しました。これは、アプリケーションをリリースする前にデバッグして修正する必要があります。
DXGI_ERROR_MORE_DATA
0x887A0003
 アプリケーションによって提供されるバッファーは、要求されたデータを保持するのに十分な大きさではありません。
DXGI_ERROR_NAME_ALREADY_EXISTS
0x887A002C
 IDXGIResource1::CreateSharedHandle の呼び出しで指定されたリソースの名前は、既に他のリソースに関連付けられています。
DXGI_ERROR_NONEXCLUSIVE
0x887A0021
 グローバル カウンター リソースが使用されており、Direct3D デバイスでは現在カウンター リソースを使用できません。
DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
0x887A0022
 リソースまたは要求は現在使用できませんが、後で使用できるようになる可能性があります。
DXGI_ERROR_NOT_FOUND
0x887A0002
 IDXGIObject::GetPrivateData を呼び出すとき、渡された GUID は、以前に IDXGIObject::SetPrivateData または IDXGIObject::SetPrivateDataInterface に渡されたものとして認識されません。 IDXGIFactory::EnumAdapters または IDXGIAdapter::EnumOutputs を呼び出すと、列挙された序数が範囲外になります。
DXGI_ERROR_REMOTE_CLIENT_DISCONNECTED
0x887A0023
 予約済み
DXGI_ERROR_REMOTE_OUTOFMEMORY
0x887A0024
 予約済み
DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE
0x887A0029
 スワップ チェーンの内容が制限された DXGI 出力 (モニター) が切断または変更されるようになりました。
DXGI_ERROR_SDK_COMPONENT_MISSING
0x887A002D
 操作は、欠落している SDK コンポーネントまたは不一致の SDK コンポーネントによって異なります。
DXGI_ERROR_SESSION_DISCONNECTED
0x887A0028
 リモート デスクトップ サービス セッションは現在切断されています。
DXGI_ERROR_UNSUPPORTED
0x887A0004
 要求された機能は、デバイスまたはドライバーではサポートされていません。
DXGI_ERROR_WAIT_TIMEOUT
0x887A0027
 次のデスクトップ フレームが使用可能になるまでのタイムアウト間隔。
DXGI_ERROR_WAS_STILL_DRAWING
0x887A000A
 操作を実行するための呼び出しが行われた時点で GPU がビジー状態であり、操作を実行またはスケジュールしませんでした。
S_OK
 メソッドはエラーなしで成功しました。

注釈

関心があるのは、メソッドが成功したか失敗したかだけです。 HRESULT 値が成功または失敗を示すかどうかをテストする最善の方法は、WinError.h で定義されている次のいずれかのマクロに値を渡すことです。

  • SUCCEEDED マクロは、成功コードの場合は TRUE、失敗コードの場合は FALSE を返します。
  • FAILED マクロは、エラー コードの場合は TRUE、成功コードの場合は FALSE を返します。

各DXGI_ERROR値の HRESULT 値は、DXGItype.h で定義されているこのマクロから決定されます。

#define _FACDXGI    0x87a
#define MAKE_DXGI_HRESULT(code) MAKE_HRESULT(1, _FACDXGI, code)

たとえば、 DXGI_ERROR_INVALID_CALL は 次のように定義0x887A0001。

#define DXGI_ERROR_INVALID_CALL                 MAKE_DXGI_HRESULT(1)

要件

要件 値
ヘッダー
Winerror.h

こちらもご覧ください

DXGI 定数