Win32 API 日本語リファレンス
ホーム › Graphics.DirectDraw › IDirectDrawGammaControl

IDirectDrawGammaControl

COM
📘 Microsoft Learn (日本語) · English
IID69c11c3e-b46b-11d1-ad7a-00c04fc29b4e継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

アプリケーションは、IDirectDrawGammaControl インターフェイスのメソッドを使用して、プライマリサーフェスの赤・緑・青のガンマランプレベルを調整します。このセクションは、本インターフェイスのメソッドに関するリファレンスです。

解説(Remarks)

IDirectDrawGammaControl インターフェイスは、DirectDrawSurface オブジェクトによってサポートされます。すなわち、DirectDrawSurface オブジェクトの IUnknown::QueryInterface メソッドを呼び出し、riid パラメーターに IID_IDirectDrawGammaControl 参照識別子を指定することで、IDirectDrawGammaControl インターフェイスへのポインターを取得できます。

LPDIRECTDRAWGAMMACONTROL データ型を使用すると、IDirectDrawGammaControl インターフェイスへのポインターを保持する変数を宣言できます。Ddraw.h ヘッダーファイルでは、このデータ型を次のコードで宣言しています。


typedef struct IDirectDrawGammaControl    FAR *LPDIRECTDRAWGAMMACONTROL;

メソッド 2

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT GetGammaRamp(DWORD param0, DDGAMMARAMP* param1)

プライマリサーフェスの赤・緑・青のガンマランプを取得します。

param0DWORDin予約済みで0を指定するフラグ値。
param1DDGAMMARAMP*inout現在のガンマランプ(RGB各256要素)を受け取る DDGAMMARAMP 構造体ポインタ。

戻り値

メソッドが成功した場合、戻り値は DD_OK です。

失敗した場合、このメソッドは次のいずれかのエラー値を返すことがあります。

vtbl 4 HRESULT SetGammaRamp(DWORD param0, DDGAMMARAMP* param1)

プライマリサーフェスの赤・緑・青のガンマランプを設定します。

param0DWORDinガンマ補正方法を示す DDSGR_ 系フラグ(キャリブレーション有無等)。
param1DDGAMMARAMP*inout設定するガンマランプを格納した DDGAMMARAMP 構造体ポインタ。

戻り値

メソッドが成功した場合、戻り値は DD_OK です。

失敗した場合、このメソッドは次のいずれかのエラー値を返すことがあります。

解説(Remarks)

すべてのシステムがガンマ較正をサポートしているわけではありません。ガンマ較正がサポートされているかどうかを判別するには、IDirectDraw7::GetCaps を呼び出し、メソッドの戻り後に、関連する DDCAPS 構造体の dwCaps2 メンバーを調べます。DDCAPS2_CANCALIBRATEGAMMA 機能フラグが存在する場合、ガンマ較正がサポートされています。

ガンマランプの較正には一定の処理オーバーヘッドが発生するため、頻繁に使用すべきではありません。

ガンマ較正をサポートしないコンピューター上で実行する際に dwFlags パラメーターに DDSGR_CALIBRATE フラグを含めても、このメソッドは失敗しません。メソッドは成功し、較正を行わずに新しいガンマランプ値を設定します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IDirectDrawGammaControl "{69C11C3E-B46B-11D1-AD7A-00C04FC29B4E}"
#usecom global IDirectDrawGammaControl IID_IDirectDrawGammaControl "{}"
#comfunc global IDirectDrawGammaControl_GetGammaRamp  3 int,var
#comfunc global IDirectDrawGammaControl_SetGammaRamp  4 int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。