DirectDraw の戻り値
次の表は、DirectDraw ドライバー提供関数が返すことができる値を示します。 DDHAL_DRIVER_Xxx 値は、実際には DWORD 戻り値で返されます。 DD_OK 値と DDERR_Xxx エラー コードは、特定の関数のパラメーターが指す構造体の ddRVal メンバーで返されます。
各関数が返すことができる特定のエラー コードについては、「リファレンス」セクションの関数の説明を参照してください。 エラー コードと戻り値の完全なリストについては、DirectDraw ヘッダー ファイル ddraw.h および dxmini.h を参照してください。 エラー コードは負の値で表され、結合できないことに注意してください。
DirectDraw ドライバーの関数は、DDHAL_DRIVER_HANDLED または DDHAL_DRIVER_NOTHANDLED の 2 つのリターン コードのいずれかを返す必要があります。 ドライバーが DDHAL_DRIVER_HANDLED を返す場合、DD_OK または ddraw.h にリストされているエラー コードのいずれかを返す必要もあります。 DirectDraw ドライバーの関数は、次の表のコードを返すことができます。 これらのコードは ddraw.h で定義されています。
リターン コード | 意味 |
---|---|
DD_OK | 要求は正常に完了しました。 |
DDHAL_DRIVER_HANDLED | ドライバーは操作を実行し、ドライバーのコールバックに渡された構造体の ddrval メンバーでその操作の有効なリターン コードを返しました。 このコードが DD_OK の場合、DirectDraw または Direct3D は関数を続行します。 それ以外の場合、DirectDraw または Direct3D はドライバーによって提供されるエラー コードを返し、関数を中止します。 |
DDHAL_DRIVER_NOCKEYHW | ディスプレイ ドライバーは、カラー キーのハードウェア リソースが不足しているため、呼び出しを処理できませんでした。 |
DDHAL_DRIVER_NOTHANDLED | ドライバーには、要求された操作に関するコメントはありません。 ドライバーが特定のコールバックを実装する必要がある場合、DirectDraw または Direct3D はエラー状態を報告します。 それ以外の場合、DirectDraw または Direct3D は、DirectDraw または Direct3D デバイスに依存しない実装を実行してドライバーコールバックが定義されていないかのように操作を処理します。 DirectDraw と Direct3D は通常、そのコールバックのパラメーター構造体の ddrval メンバーに返されるすべての値を無視します。 |
DDERR_GENERIC | 未定義のエラー状態があります。 |
DDERR_OUTOFCAPS | 要求された操作に必要なハードウェアが既に割り当てられています。 |
DDERR_UNSUPPORTED | この操作はサポートされていません。 |
ビデオ ミニポート ドライバーに実装されている DxApi 関数は、次の表のいずれかのコードを返します。 これらのコードは dxmini.h で定義されています。
リターン コード | 意味 |
---|---|
DX_OK | 要求は正常に完了しました。 |
DXERR_GENERIC | 未定義のエラー状態があります。 |
DXERR_OUTOFCAPS | 要求された操作に必要なハードウェアが既に割り当てられています。 |
DXERR_UNSUPPORTED | この操作はサポートされていません。 |
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示