IDirectDrawGammaControl::SetGammaRamp メソッド (ddraw.h)
プライマリ サーフェスの赤、緑、青のガンマ ランプを設定します。
構文
HRESULT SetGammaRamp(
[in] DWORD unnamedParam1,
[in] LPDDGAMMARAMP unnamedParam2
);
パラメーター
[in] unnamedParam1
ガンマ調整が必要かどうかを示すフラグ。 このパラメーターを DDSGR_CALIBRATE に設定して、校正器がディスプレイの物理的な特性に従ってガンマ ランプを調整するように要求します。これにより、結果はすべてのコンピューターで同じになります。 調整が必要ない場合は、このパラメーターを 0 に設定します。
[in] unnamedParam2
新しい赤、緑、青のガンマ ランプ エントリを含む DDGAMMARAMP 構造体へのポインター。 各配列は、フレーム バッファー内の色値を、デジタルアナログ 変換 (DAC) に渡される色の値にマップします。
戻り値
メソッドが成功した場合、戻り値はDD_OK。
失敗した場合、メソッドは次のいずれかのエラー値を返すことができます。
- DDERR_EXCEPTION
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
- DDERR_OUTOFMEMORY
注釈
すべてのシステムでガンマキャリブレーションがサポートされているわけではありません。 ガンマ調整がサポートされているかどうかを確認するには、IDirectDraw7::GetCaps を呼び出し、メソッドが戻った後、関連付けられている DDCAPS 構造体の dwCaps2 メンバーを調べます。 DDCAPS2_CANCALIBRATEGAMMA機能フラグが存在する場合は、ガンマ調整がサポートされます。
ガンマ ランプを調整すると、処理オーバーヘッドが発生し、頻繁に使用しないでください。
ガンマ調整をサポートしていないコンピューターでを実行するときに dwFlags パラメーターにDDSGR_CALIBRATE フラグを含めても、このメソッドは失敗しません。 このメソッドは成功し、調整なしで新しいガンマ ランプ値を設定します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | ddraw.h |
| Library | Ddraw.lib |
| [DLL] | Ddraw.dll |