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

MFT_INPUT_STREAM_INFO

構造体
サイズx64: 24 バイト / x86: 24 バイト

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

フィールド

フィールドサイズx64x86説明
hnsMaxLatencyLONGLONG8+0+0入力サンプルと、それに対応する出力サンプルとの間の最大時間 (100 ナノ秒単位)。たとえば、再生時間が 1 秒のサンプルを 2 つバッファリングする MFT の最大待ち時間は 2 秒です。MFT がバッファリングを行わず、常に入力サンプルをそのまま出力サンプルに変換する場合、待ち時間は 0 です。
dwFlagsDWORD4+8+8_MFT_INPUT_STREAM_INFO_FLAGS 列挙型の 0 個以上のフラグのビット単位の OR
cbSizeDWORD4+12+12各入力バッファーの最小サイズ (バイト単位)。サイズが可変の場合、または MFT が特定のサイズを必要としない場合、値は 0 です。非圧縮オーディオの場合、この値はオーディオフレームのサイズにする必要があります。このサイズは、メディアタイプの MF_MT_AUDIO_BLOCK_ALIGNMENT 属性から取得できます。
cbMaxLookaheadDWORD4+16+16先読みを行うために MFT が保持する入力データの最大量 (バイト単位)。先読み とは、データを処理する前に、その先のデータを参照する動作のことです。この値は最悪の場合を想定した値でなければなりません。MFT が先読みバッファーを保持しない場合、値は 0 です。
cbAlignmentDWORD4+20+20入力バッファーに必要なメモリアラインメント。MFT が特定のアラインメントを必要としない場合、値は 0 です。

公式ドキュメント

Media Foundation トランスフォーム (MFT) の入力ストリームに関する情報を格納します。これらの値を取得するには、IMFTransform::GetInputStreamInfo を呼び出します。

解説(Remarks)

メディアタイプが設定される前に有効と見なせる値は、dwFlags メンバーの MFT_INPUT_STREAM_REMOVABLE フラグと MFT_INPUT_STREAM_OPTIONAL フラグだけです。

すべての入力ストリームおよび出力ストリーム (省略可能なストリームを除く) にメディアタイプを設定した後は、GetInputStreamInfo メソッドが返すすべての値が有効になります。異なるメディアタイプを設定すると、これらの値は変化する場合があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// MFT_INPUT_STREAM_INFO  (x64 24 / x86 24 バイト)
typedef struct MFT_INPUT_STREAM_INFO {
    LONGLONG hnsMaxLatency;
    DWORD dwFlags;
    DWORD cbSize;
    DWORD cbMaxLookahead;
    DWORD cbAlignment;
} MFT_INPUT_STREAM_INFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MFT_INPUT_STREAM_INFO
{
    public long hnsMaxLatency;
    public uint dwFlags;
    public uint cbSize;
    public uint cbMaxLookahead;
    public uint cbAlignment;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MFT_INPUT_STREAM_INFO
    Public hnsMaxLatency As Long
    Public dwFlags As UInteger
    Public cbSize As UInteger
    Public cbMaxLookahead As UInteger
    Public cbAlignment As UInteger
End Structure
import ctypes
from ctypes import wintypes

class MFT_INPUT_STREAM_INFO(ctypes.Structure):
    _fields_ = [
        ("hnsMaxLatency", ctypes.c_longlong),
        ("dwFlags", wintypes.DWORD),
        ("cbSize", wintypes.DWORD),
        ("cbMaxLookahead", wintypes.DWORD),
        ("cbAlignment", wintypes.DWORD),
    ]
#[repr(C)]
pub struct MFT_INPUT_STREAM_INFO {
    pub hnsMaxLatency: i64,
    pub dwFlags: u32,
    pub cbSize: u32,
    pub cbMaxLookahead: u32,
    pub cbAlignment: u32,
}
import "golang.org/x/sys/windows"

type MFT_INPUT_STREAM_INFO struct {
	hnsMaxLatency int64
	dwFlags uint32
	cbSize uint32
	cbMaxLookahead uint32
	cbAlignment uint32
}
type
  MFT_INPUT_STREAM_INFO = record
    hnsMaxLatency: Int64;
    dwFlags: DWORD;
    cbSize: DWORD;
    cbMaxLookahead: DWORD;
    cbAlignment: DWORD;
  end;
const MFT_INPUT_STREAM_INFO = extern struct {
    hnsMaxLatency: i64,
    dwFlags: u32,
    cbSize: u32,
    cbMaxLookahead: u32,
    cbAlignment: u32,
};
type
  MFT_INPUT_STREAM_INFO {.bycopy.} = object
    hnsMaxLatency: int64
    dwFlags: uint32
    cbSize: uint32
    cbMaxLookahead: uint32
    cbAlignment: uint32
struct MFT_INPUT_STREAM_INFO
{
    long hnsMaxLatency;
    uint dwFlags;
    uint cbSize;
    uint cbMaxLookahead;
    uint cbAlignment;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; MFT_INPUT_STREAM_INFO サイズ: 24 バイト(x64)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; hnsMaxLatency : LONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; dwFlags : DWORD (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; cbSize : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; cbMaxLookahead : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; cbAlignment : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global MFT_INPUT_STREAM_INFO
    #field int64 hnsMaxLatency
    #field int dwFlags
    #field int cbSize
    #field int cbMaxLookahead
    #field int cbAlignment
#endstruct

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