Win32 API 日本語リファレンス
ホーム › Media.DirectShow › VIDEO_STREAM_CONFIG_CAPS

VIDEO_STREAM_CONFIG_CAPS

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 128 バイト / x86: 128 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールド型サイズx64x86説明
guidGUID16+0+0形式の種類を識別する GUID です。たとえば FORMAT_VideoInfo や FORMAT_VideoInfo2 です。詳細については、AM_MEDIA_TYPE 構造体の formattype メンバーを参照してください。
VideoStandardDWORD4+16+16サポートされるアナログビデオ規格です。値は AnalogVideoStandard 列挙型のフラグのビット単位の OR による組み合わせ、または 0 です。
InputSizeSIZE8+20+20

入力ビデオ信号のネイティブサイズです。コンプレッサーの場合、このサイズは入力ピンから取得されます。キャプチャフィルターの場合、このサイズは、すべてのピクセルが一意のまま保たれる状態でフィルターがデジタル化できる最大の信号です。

Note 非推奨です。
MinCroppingSizeSIZE8+28+28

許容される最小のソース矩形です。ソース矩形は、VIDEOINFOHEADER 構造体または VIDEOINFOHEADER2 構造体の rcSource メンバーで定義されます。

Note 非推奨です。
MaxCroppingSizeSIZE8+36+36

許容される最大のソース矩形です。

Note 非推奨です。
CropGranularityXINT4+44+44

ソース矩形の水平方向の粒度です。この値は、MinCroppingSize と MaxCroppingSize の間で有効な増分を指定します。

Note 非推奨です。
CropGranularityYINT4+48+48

ソース矩形の垂直方向の粒度です。この値は、MinCroppingSize と MaxCroppingSize の間で有効な増分を指定します。

Note 非推奨です。
CropAlignXINT4+52+52

ソース矩形に必要な水平方向の配置境界です。

Note 非推奨です。
CropAlignYINT4+56+56

ソース矩形に必要な垂直方向の配置境界です。

Note 非推奨です。
MinOutputSizeSIZE8+60+60

最小の出力サイズです。

Note 非推奨です。
MaxOutputSizeSIZE8+68+68

最大の出力サイズです。

Note 非推奨です。
OutputGranularityXINT4+76+76

出力幅の粒度です。この値は、MinOutputSize と MaxOutputSize の間で有効な増分を指定します。

Note 非推奨です。
OutputGranularityYINT4+80+80

出力高さの粒度です。この値は、MinOutputSize と MaxOutputSize の間で有効な増分を指定します。

Note 非推奨です。
StretchTapsXINT4+84+84

フィルターが画像を水平方向にどの程度うまく拡大できるかを示します。

Note 非推奨です。
StretchTapsYINT4+88+88

フィルターが画像を垂直方向にどの程度うまく拡大できるかを示します。

Note 非推奨です。
ShrinkTapsXINT4+92+92

フィルターが画像を水平方向にどの程度うまく縮小できるかを示します。

Note 非推奨です。
ShrinkTapsYINT4+96+96

フィルターが画像を垂直方向にどの程度うまく縮小できるかを示します。

Note 非推奨です。
直前の 4 つの構造体メンバーは、次の値を使用します。
値 意味
0
 拡大/縮小をサポートしません。
1
 ピクセルの複製 (拡大) またはピクセルの間引き (縮小) を使用します
2
 補間 (2 タップ) を使用します
3 以上
 補間 (>2 タップ) を使用します
MinFrameIntervalLONGLONG8+104+104フレームの最小継続時間を 100 ナノ秒単位で指定します。この値はキャプチャフィルターにのみ適用されます。
MaxFrameIntervalLONGLONG8+112+112フレームの最大継続時間を 100 ナノ秒単位で指定します。この値はキャプチャフィルターにのみ適用されます。
MinBitsPerSecondINT4+120+120

このピンが生成できる最小データレートです。

Note 非推奨です。
MaxBitsPerSecondINT4+124+124

このピンが生成できる最大データレートです。

Note 非推奨です。

公式ドキュメント

[このページに関連する機能である 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 を使用するように書き直すことを推奨します。]

VIDEO_STREAM_CONFIG_CAPS 構造体は、ビデオ形式の範囲を記述します。ビデオ圧縮フィルターおよびビデオキャプチャフィルターは、この構造体を使用して、自身が生成できる形式を記述します。

Note この構造体の大部分は非推奨であり、次の構造体メンバーだけが例外です。
  • guid
  • VideoStandard
  • MinFrameInterval
  • MaxFrameInterval
アプリケーションは MinFrameInterval と MaxFrameInterval を使用して、ビデオキャプチャデバイスがサポートするフレームレートの範囲を取得できます。アプリケーションは、この構造体のそれ以外のメンバーの使用を避けてください。代わりに、IAMStreamConfig::GetFormat メソッドが返す AM_MEDIA_TYPE 構造体を使用してください。

解説(Remarks)

IAMStreamConfig::GetStreamCaps メソッドはこの構造体を返します。アプリケーションはこの情報を使用して、ビデオ圧縮フィルターまたはビデオキャプチャフィルターの出力形式を変更できます。

たとえば、フィルターがソース矩形について次の値を返す場合を考えます。

これらの数値は、VIDEOINFOHEADER 構造体または VIDEOINFOHEADER2 構造体の rcSource メンバーに指定できる有効な矩形の集合を定義します。この例では、最小のソース矩形は幅 160 ピクセル x 高さ 120 ピクセルです。幅は 4 ピクセル刻みで最大 320 まで大きくできます。高さは 8 ピクセル刻みで最大 240 まで大きくできます。つまり、有効な幅は 160、164、168 ... 320 であり、有効な高さは 120、128、136 ... 240 です。

CropAlignX メンバーと CropAlignY メンバーは、ソース矩形の左上隅を配置できる位置を定義します。たとえば、前述の値の場合、次の矩形が有効です。

同様に、MinOutputSize、MaxOutputSize、OutputGranularityX、OutputGranularityY の各メンバーは、BITMAPINFOHEADER 構造体の biWidth メンバーと biHeight メンバーでサポートされる値を定義します。

キャプチャフィルターの場合、MinFrameInterval メンバーと MaxFrameInterval メンバーは、VIDEOINFOHEADER 構造体または VIDEOINFOHEADER2 構造体の AvgTimePerFrame メンバーで指定される、各フレームの継続時間の最小値と最大値を定義します。フィルターは、これら 2 つの値の間にあるすべてのフレームレートをサポートしているとは限りません。IAMStreamConfig::SetFormat メソッドは、フィルターがサポートする最も近い値にフレームレートを設定します。SetFormat が成功した場合は、IAMStreamConfig::GetFormat を呼び出して実際のフレームレートを確認してください。

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

各言語での定義

#include <windows.h>

// SIZE  (x64 8 / x86 8 バイト)
typedef struct SIZE {
    INT cx;
    INT cy;
} SIZE;

// VIDEO_STREAM_CONFIG_CAPS  (x64 128 / x86 128 バイト)
typedef struct VIDEO_STREAM_CONFIG_CAPS {
    GUID guid;
    DWORD VideoStandard;
    SIZE InputSize;
    SIZE MinCroppingSize;
    SIZE MaxCroppingSize;
    INT CropGranularityX;
    INT CropGranularityY;
    INT CropAlignX;
    INT CropAlignY;
    SIZE MinOutputSize;
    SIZE MaxOutputSize;
    INT OutputGranularityX;
    INT OutputGranularityY;
    INT StretchTapsX;
    INT StretchTapsY;
    INT ShrinkTapsX;
    INT ShrinkTapsY;
    LONGLONG MinFrameInterval;
    LONGLONG MaxFrameInterval;
    INT MinBitsPerSecond;
    INT MaxBitsPerSecond;
} VIDEO_STREAM_CONFIG_CAPS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct SIZE
{
    public int cx;
    public int cy;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct VIDEO_STREAM_CONFIG_CAPS
{
    public Guid guid;
    public uint VideoStandard;
    public SIZE InputSize;
    public SIZE MinCroppingSize;
    public SIZE MaxCroppingSize;
    public int CropGranularityX;
    public int CropGranularityY;
    public int CropAlignX;
    public int CropAlignY;
    public SIZE MinOutputSize;
    public SIZE MaxOutputSize;
    public int OutputGranularityX;
    public int OutputGranularityY;
    public int StretchTapsX;
    public int StretchTapsY;
    public int ShrinkTapsX;
    public int ShrinkTapsY;
    public long MinFrameInterval;
    public long MaxFrameInterval;
    public int MinBitsPerSecond;
    public int MaxBitsPerSecond;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure SIZE
    Public cx As Integer
    Public cy As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure VIDEO_STREAM_CONFIG_CAPS
    Public guid As Guid
    Public VideoStandard As UInteger
    Public InputSize As SIZE
    Public MinCroppingSize As SIZE
    Public MaxCroppingSize As SIZE
    Public CropGranularityX As Integer
    Public CropGranularityY As Integer
    Public CropAlignX As Integer
    Public CropAlignY As Integer
    Public MinOutputSize As SIZE
    Public MaxOutputSize As SIZE
    Public OutputGranularityX As Integer
    Public OutputGranularityY As Integer
    Public StretchTapsX As Integer
    Public StretchTapsY As Integer
    Public ShrinkTapsX As Integer
    Public ShrinkTapsY As Integer
    Public MinFrameInterval As Long
    Public MaxFrameInterval As Long
    Public MinBitsPerSecond As Integer
    Public MaxBitsPerSecond As Integer
End Structure
import ctypes
from ctypes import wintypes

class SIZE(ctypes.Structure):
    _fields_ = [
        ("cx", ctypes.c_int),
        ("cy", ctypes.c_int),
    ]

class VIDEO_STREAM_CONFIG_CAPS(ctypes.Structure):
    _fields_ = [
        ("guid", GUID),
        ("VideoStandard", wintypes.DWORD),
        ("InputSize", SIZE),
        ("MinCroppingSize", SIZE),
        ("MaxCroppingSize", SIZE),
        ("CropGranularityX", ctypes.c_int),
        ("CropGranularityY", ctypes.c_int),
        ("CropAlignX", ctypes.c_int),
        ("CropAlignY", ctypes.c_int),
        ("MinOutputSize", SIZE),
        ("MaxOutputSize", SIZE),
        ("OutputGranularityX", ctypes.c_int),
        ("OutputGranularityY", ctypes.c_int),
        ("StretchTapsX", ctypes.c_int),
        ("StretchTapsY", ctypes.c_int),
        ("ShrinkTapsX", ctypes.c_int),
        ("ShrinkTapsY", ctypes.c_int),
        ("MinFrameInterval", ctypes.c_longlong),
        ("MaxFrameInterval", ctypes.c_longlong),
        ("MinBitsPerSecond", ctypes.c_int),
        ("MaxBitsPerSecond", ctypes.c_int),
    ]
#[repr(C)]
pub struct SIZE {
    pub cx: i32,
    pub cy: i32,
}

#[repr(C)]
pub struct VIDEO_STREAM_CONFIG_CAPS {
    pub guid: GUID,
    pub VideoStandard: u32,
    pub InputSize: SIZE,
    pub MinCroppingSize: SIZE,
    pub MaxCroppingSize: SIZE,
    pub CropGranularityX: i32,
    pub CropGranularityY: i32,
    pub CropAlignX: i32,
    pub CropAlignY: i32,
    pub MinOutputSize: SIZE,
    pub MaxOutputSize: SIZE,
    pub OutputGranularityX: i32,
    pub OutputGranularityY: i32,
    pub StretchTapsX: i32,
    pub StretchTapsY: i32,
    pub ShrinkTapsX: i32,
    pub ShrinkTapsY: i32,
    pub MinFrameInterval: i64,
    pub MaxFrameInterval: i64,
    pub MinBitsPerSecond: i32,
    pub MaxBitsPerSecond: i32,
}
import "golang.org/x/sys/windows"

type SIZE struct {
	cx int32
	cy int32
}

type VIDEO_STREAM_CONFIG_CAPS struct {
	guid windows.GUID
	VideoStandard uint32
	InputSize SIZE
	MinCroppingSize SIZE
	MaxCroppingSize SIZE
	CropGranularityX int32
	CropGranularityY int32
	CropAlignX int32
	CropAlignY int32
	MinOutputSize SIZE
	MaxOutputSize SIZE
	OutputGranularityX int32
	OutputGranularityY int32
	StretchTapsX int32
	StretchTapsY int32
	ShrinkTapsX int32
	ShrinkTapsY int32
	MinFrameInterval int64
	MaxFrameInterval int64
	MinBitsPerSecond int32
	MaxBitsPerSecond int32
}
type
  SIZE = record
    cx: Integer;
    cy: Integer;
  end;

  VIDEO_STREAM_CONFIG_CAPS = record
    guid: TGUID;
    VideoStandard: DWORD;
    InputSize: SIZE;
    MinCroppingSize: SIZE;
    MaxCroppingSize: SIZE;
    CropGranularityX: Integer;
    CropGranularityY: Integer;
    CropAlignX: Integer;
    CropAlignY: Integer;
    MinOutputSize: SIZE;
    MaxOutputSize: SIZE;
    OutputGranularityX: Integer;
    OutputGranularityY: Integer;
    StretchTapsX: Integer;
    StretchTapsY: Integer;
    ShrinkTapsX: Integer;
    ShrinkTapsY: Integer;
    MinFrameInterval: Int64;
    MaxFrameInterval: Int64;
    MinBitsPerSecond: Integer;
    MaxBitsPerSecond: Integer;
  end;
const SIZE = extern struct {
    cx: i32,
    cy: i32,
};

const VIDEO_STREAM_CONFIG_CAPS = extern struct {
    guid: GUID,
    VideoStandard: u32,
    InputSize: SIZE,
    MinCroppingSize: SIZE,
    MaxCroppingSize: SIZE,
    CropGranularityX: i32,
    CropGranularityY: i32,
    CropAlignX: i32,
    CropAlignY: i32,
    MinOutputSize: SIZE,
    MaxOutputSize: SIZE,
    OutputGranularityX: i32,
    OutputGranularityY: i32,
    StretchTapsX: i32,
    StretchTapsY: i32,
    ShrinkTapsX: i32,
    ShrinkTapsY: i32,
    MinFrameInterval: i64,
    MaxFrameInterval: i64,
    MinBitsPerSecond: i32,
    MaxBitsPerSecond: i32,
};
type
  SIZE {.bycopy.} = object
    cx: int32
    cy: int32

  VIDEO_STREAM_CONFIG_CAPS {.bycopy.} = object
    guid: GUID
    VideoStandard: uint32
    InputSize: SIZE
    MinCroppingSize: SIZE
    MaxCroppingSize: SIZE
    CropGranularityX: int32
    CropGranularityY: int32
    CropAlignX: int32
    CropAlignY: int32
    MinOutputSize: SIZE
    MaxOutputSize: SIZE
    OutputGranularityX: int32
    OutputGranularityY: int32
    StretchTapsX: int32
    StretchTapsY: int32
    ShrinkTapsX: int32
    ShrinkTapsY: int32
    MinFrameInterval: int64
    MaxFrameInterval: int64
    MinBitsPerSecond: int32
    MaxBitsPerSecond: int32
struct SIZE
{
    int cx;
    int cy;
}

struct VIDEO_STREAM_CONFIG_CAPS
{
    GUID guid;
    uint VideoStandard;
    SIZE InputSize;
    SIZE MinCroppingSize;
    SIZE MaxCroppingSize;
    int CropGranularityX;
    int CropGranularityY;
    int CropAlignX;
    int CropAlignY;
    SIZE MinOutputSize;
    SIZE MaxOutputSize;
    int OutputGranularityX;
    int OutputGranularityY;
    int StretchTapsX;
    int StretchTapsY;
    int ShrinkTapsX;
    int ShrinkTapsY;
    long MinFrameInterval;
    long MaxFrameInterval;
    int MinBitsPerSecond;
    int MaxBitsPerSecond;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; VIDEO_STREAM_CONFIG_CAPS サイズ: 128 バイト(x64)
dim st, 32    ; 4byte整数×32(構造体サイズ 128 / 4 切り上げ)
; guid : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; VideoStandard : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; InputSize : SIZE (+20, 8byte)  varptr(st)+20 を基点に操作(8byte:入れ子/配列)
; MinCroppingSize : SIZE (+28, 8byte)  varptr(st)+28 を基点に操作(8byte:入れ子/配列)
; MaxCroppingSize : SIZE (+36, 8byte)  varptr(st)+36 を基点に操作(8byte:入れ子/配列)
; CropGranularityX : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; CropGranularityY : INT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; CropAlignX : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; CropAlignY : INT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; MinOutputSize : SIZE (+60, 8byte)  varptr(st)+60 を基点に操作(8byte:入れ子/配列)
; MaxOutputSize : SIZE (+68, 8byte)  varptr(st)+68 を基点に操作(8byte:入れ子/配列)
; OutputGranularityX : INT (+76, 4byte)  st.19 = 値  /  値 = st.19   (lpoke/lpeek も可)
; OutputGranularityY : INT (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; StretchTapsX : INT (+84, 4byte)  st.21 = 値  /  値 = st.21   (lpoke/lpeek も可)
; StretchTapsY : INT (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ShrinkTapsX : INT (+92, 4byte)  st.23 = 値  /  値 = st.23   (lpoke/lpeek も可)
; ShrinkTapsY : INT (+96, 4byte)  st.24 = 値  /  値 = st.24   (lpoke/lpeek も可)
; MinFrameInterval : LONGLONG (+104, 8byte)  qpoke st,104,値 / qpeek(st,104)  ※IronHSPのみ。3.7/3.8は lpoke st,104,下位 : lpoke st,108,上位
; MaxFrameInterval : LONGLONG (+112, 8byte)  qpoke st,112,値 / qpeek(st,112)  ※IronHSPのみ。3.7/3.8は lpoke st,112,下位 : lpoke st,116,上位
; MinBitsPerSecond : INT (+120, 4byte)  st.30 = 値  /  値 = st.30   (lpoke/lpeek も可)
; MaxBitsPerSecond : INT (+124, 4byte)  st.31 = 値  /  値 = st.31   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global SIZE
    #field int cx
    #field int cy
#endstruct

#defstruct global VIDEO_STREAM_CONFIG_CAPS
    #field GUID guid
    #field int VideoStandard
    #field SIZE InputSize
    #field SIZE MinCroppingSize
    #field SIZE MaxCroppingSize
    #field int CropGranularityX
    #field int CropGranularityY
    #field int CropAlignX
    #field int CropAlignY
    #field SIZE MinOutputSize
    #field SIZE MaxOutputSize
    #field int OutputGranularityX
    #field int OutputGranularityY
    #field int StretchTapsX
    #field int StretchTapsY
    #field int ShrinkTapsX
    #field int ShrinkTapsY
    #field int64 MinFrameInterval
    #field int64 MaxFrameInterval
    #field int MinBitsPerSecond
    #field int MaxBitsPerSecond
#endstruct

stdim st, VIDEO_STREAM_CONFIG_CAPS        ; NSTRUCT 変数を確保
st->VideoStandard = 100
mes "VideoStandard=" + st->VideoStandard