PDD_VPORTCB_COLORCONTROL

DdVideoPortColorControl コールバック関数は、VPE オブジェクトのカラーコントロールを取得または設定します。

DdVideoPortColorControl は、次のいずれかのコールバックコードを返します。

DDVIDEOPORTCAPS 構造体で DDVPCAPS_COLORCONTROL フラグを設定する DirectDraw ドライバーは、DdVideoPortColorControl を実装する必要があります。

lpColorControl が指す DD_VPORTCOLORDATA 構造体の dwFlags メンバーの値に応じて、ドライバーは次の処理を行う必要があります。

• dwFlags が DDRAWI_VPORTGETCOLOR の場合、ドライバーは、サポートしている DDCOLORCONTROL 構造体の各メンバーに、VPE オブジェクトの現在のカラーコントロール設定を格納する必要があります。ドライバーは、データを書き込んだすべてのカラーコントロールメンバーについて、DDCOLORCONTROL の dwFlags メンバーの対応するビットを設定する必要があります。

  DdVideoPortColorControl は、VPE オブジェクトのカラーコントロール機能を判定するために呼び出されることがあります。そのため、要求されたカラーコントロール機能をサポートしていない場合、ドライバーはこの呼び出しを失敗させる必要があります。

• dwFlags が DDRAWI_VPORTSETCOLOR の場合、ドライバーは、VPE オブジェクトのカラーコントロール設定を DDCOLORCONTROL 構造体で指定された値に設定する必要があります。ドライバーは、DDCOLORCONTROL の dwFlags メンバーを確認して、どの構造体メンバーに有効なデータが含まれているかを判断する必要があります。