VMR9ProcAmpControl
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| dwSize | DWORD | 4 | +0 | +0 | 構造体のサイズ (バイト単位)。値は sizeof(VMR9ProcAmpControl) でなければなりません。 |
| dwFlags | DWORD | 4 | +4 | +4 | VMR9ProcAmpControlFlags 列挙型のフラグをビット単位で組み合わせた値で、ドライバーがどのプロパティをサポートしているかを示します。 |
| Brightness | FLOAT | 4 | +8 | +8 | 画像の明るさを指定します。ブライトネス (ブラックレベルセットアップとも呼ばれます) は、表示される黒レベルを指定します。機能的には、画像内のすべての輝度ワードに対して同じ数の量子化ステップ (ビット) を加算または減算します。 |
| Contrast | FLOAT | 4 | +12 | +12 | 画像のコントラストを指定します。コントラストは、画像内の明暗の相対的な値を変化させます。機能的には、入力値の範囲を、より狭いまたはより広い出力値の範囲にマッピングします。 |
| Hue | FLOAT | 4 | +16 | +16 | 画像の色相を指定します。知覚的には、色相はおおよそ「色」に対応します。機能的には、色相は色差成分の位相関係です。度単位で指定し、有効範囲の公称値は -180 度から 180 度、既定値は 0 です。 |
| Saturation | FLOAT | 4 | +20 | +20 | 画像の彩度を指定します。彩度は画像の色の濃さを変化させます。機能的にはコントラストに似ていますが、画像の色差成分に対して作用します。 |
公式ドキュメント
[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、新しいコードでは可能な限り DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]
VMR9ProcAmpControl 構造体は、ビデオストリームに対して実行する画像調整を指定します。この構造体は Video Mixing Renderer Filter 9 (VMR-9) で使用されます。
解説(Remarks)
各プロパティの有効な値の範囲は、グラフィックスデバイスドライバーによって異なります。各プロパティの範囲を取得するには、IVMRMixerControl9::GetProcAmpControlRange メソッドを呼び出します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// VMR9ProcAmpControl (x64 24 / x86 24 バイト)
typedef struct VMR9ProcAmpControl {
DWORD dwSize;
DWORD dwFlags;
FLOAT Brightness;
FLOAT Contrast;
FLOAT Hue;
FLOAT Saturation;
} VMR9ProcAmpControl;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VMR9ProcAmpControl
{
public uint dwSize;
public uint dwFlags;
public float Brightness;
public float Contrast;
public float Hue;
public float Saturation;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VMR9ProcAmpControl
Public dwSize As UInteger
Public dwFlags As UInteger
Public Brightness As Single
Public Contrast As Single
Public Hue As Single
Public Saturation As Single
End Structureimport ctypes
from ctypes import wintypes
class VMR9ProcAmpControl(ctypes.Structure):
_fields_ = [
("dwSize", wintypes.DWORD),
("dwFlags", wintypes.DWORD),
("Brightness", ctypes.c_float),
("Contrast", ctypes.c_float),
("Hue", ctypes.c_float),
("Saturation", ctypes.c_float),
]#[repr(C)]
pub struct VMR9ProcAmpControl {
pub dwSize: u32,
pub dwFlags: u32,
pub Brightness: f32,
pub Contrast: f32,
pub Hue: f32,
pub Saturation: f32,
}import "golang.org/x/sys/windows"
type VMR9ProcAmpControl struct {
dwSize uint32
dwFlags uint32
Brightness float32
Contrast float32
Hue float32
Saturation float32
}type
VMR9ProcAmpControl = record
dwSize: DWORD;
dwFlags: DWORD;
Brightness: Single;
Contrast: Single;
Hue: Single;
Saturation: Single;
end;const VMR9ProcAmpControl = extern struct {
dwSize: u32,
dwFlags: u32,
Brightness: f32,
Contrast: f32,
Hue: f32,
Saturation: f32,
};type
VMR9ProcAmpControl {.bycopy.} = object
dwSize: uint32
dwFlags: uint32
Brightness: float32
Contrast: float32
Hue: float32
Saturation: float32struct VMR9ProcAmpControl
{
uint dwSize;
uint dwFlags;
float Brightness;
float Contrast;
float Hue;
float Saturation;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VMR9ProcAmpControl サイズ: 24 バイト(x64)
dim st, 6 ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte) st.1 = 値 / 値 = st.1 (lpoke/lpeek も可)
; Brightness : FLOAT (+8, 4byte) st.2 = 値 / 値 = st.2 (lpoke/lpeek も可)
; Contrast : FLOAT (+12, 4byte) st.3 = 値 / 値 = st.3 (lpoke/lpeek も可)
; Hue : FLOAT (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; Saturation : FLOAT (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global VMR9ProcAmpControl
#field int dwSize
#field int dwFlags
#field float Brightness
#field float Contrast
#field float Hue
#field float Saturation
#endstruct
stdim st, VMR9ProcAmpControl ; NSTRUCT 変数を確保
st->dwSize = 100
mes "dwSize=" + st->dwSize