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

MFT_OUTPUT_DATA_BUFFER

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

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

フィールド

フィールドサイズx64x86説明
dwStreamIDDWORD4+0+0

出力ストリームの識別子です。ProcessOutput を呼び出す前に、このメンバーに有効なストリーム識別子を設定します。

例外: IMFTransform::GetStreamIDs メソッドが E_NOTIMPL を返す場合、MFT はこのメンバーを無視し、ProcessOutput メソッドの pOutputSamples 配列のインデックスをストリーム識別子として使用します。つまり、配列の最初の要素をストリーム 0 に、2 番目の要素をストリーム 1 に、というように使用します。この場合、呼び出し元は dwStreamID を配列のインデックスと同じ値に設定することが推奨されます (必須ではありません)。

pSampleIMFSample*8/4+8+4IMFSample インターフェイスへのポインターです。ProcessOutput を呼び出す前に、このメンバーに有効な IMFSample ポインターまたは NULL を設定します。詳細については「解説」を参照してください。
dwStatusDWORD4+16+8ProcessOutput を呼び出す前に、このメンバーを 0 に設定します。メソッドから戻ったとき、MFT はこのメンバーに _MFT_OUTPUT_DATA_BUFFER_FLAGS 列挙型の値を設定する場合があります。それ以外の場合、MFT はこのメンバーを 0 のままにします。
pEventsIMFCollection*8/4+24+12ProcessOutput を呼び出す前に、このメンバーを NULL に設定します。出力時に、MFT はこのメンバーに有効な IMFCollection インターフェイスポインターを設定する場合があります。このポインターは、0 個以上のイベントを含むコレクションを表します。各イベントを取得するには、IMFCollection::GetElement を呼び出し、返された IUnknown ポインターに対して IMFMediaEvent インターフェイスをクエリします。ProcessOutput メソッドから戻った後、ポインターが NULL でない場合は、呼び出し元が IMFCollection ポインターを解放する責任を負います。

公式ドキュメント

Media Foundation トランスフォームの出力バッファーに関する情報を格納します。この構造体は IMFTransform::ProcessOutput メソッドで使用されます。

解説(Remarks)

選択されている出力ストリームごとに MFT_OUTPUT_DATA_BUFFER 構造体を用意する必要があります。

MFT は、出力サンプルについて 2 種類の割り当てモデルをサポートできます。

特定の出力ストリームについて MFT がどちらのモデルをサポートしているかを調べるには、IMFTransform::GetOutputStreamInfo を呼び出し、dwFlags の値を確認します。
フラグ 割り当てモデル
MFT_OUTPUT_STREAM_PROVIDES_SAMPLES MFT がそのストリームの出力サンプルを割り当てます。このストリームでは pSampleNULL に設定します。
MFT_OUTPUT_STREAM_CAN_PROVIDE_SAMPLES MFT は両方の割り当てモデルをサポートします。
どちらでもない (既定) クライアントがそのストリームの出力サンプルを割り当てる必要があります。

ProcessOutput の動作は、pSample の初期値と、ProcessOutput メソッドの dwFlags パラメーターの値によって異なります。

これら以外の組み合わせは無効であり、ProcessOutputE_INVALIDARG を返します。

ProcessOutput の 1 回の呼び出しで、0 個以上のイベントと、出力ストリームごとに最大 1 個のサンプルが生成されます。

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

各言語での定義

#include <windows.h>

// MFT_OUTPUT_DATA_BUFFER  (x64 32 / x86 16 バイト)
typedef struct MFT_OUTPUT_DATA_BUFFER {
    DWORD dwStreamID;
    IMFSample* pSample;
    DWORD dwStatus;
    IMFCollection* pEvents;
} MFT_OUTPUT_DATA_BUFFER;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct MFT_OUTPUT_DATA_BUFFER
{
    public uint dwStreamID;
    public IntPtr pSample;
    public uint dwStatus;
    public IntPtr pEvents;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure MFT_OUTPUT_DATA_BUFFER
    Public dwStreamID As UInteger
    Public pSample As IntPtr
    Public dwStatus As UInteger
    Public pEvents As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class MFT_OUTPUT_DATA_BUFFER(ctypes.Structure):
    _fields_ = [
        ("dwStreamID", wintypes.DWORD),
        ("pSample", ctypes.c_void_p),
        ("dwStatus", wintypes.DWORD),
        ("pEvents", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct MFT_OUTPUT_DATA_BUFFER {
    pub dwStreamID: u32,
    pub pSample: *mut core::ffi::c_void,
    pub dwStatus: u32,
    pub pEvents: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type MFT_OUTPUT_DATA_BUFFER struct {
	dwStreamID uint32
	pSample uintptr
	dwStatus uint32
	pEvents uintptr
}
type
  MFT_OUTPUT_DATA_BUFFER = record
    dwStreamID: DWORD;
    pSample: Pointer;
    dwStatus: DWORD;
    pEvents: Pointer;
  end;
const MFT_OUTPUT_DATA_BUFFER = extern struct {
    dwStreamID: u32,
    pSample: ?*anyopaque,
    dwStatus: u32,
    pEvents: ?*anyopaque,
};
type
  MFT_OUTPUT_DATA_BUFFER {.bycopy.} = object
    dwStreamID: uint32
    pSample: pointer
    dwStatus: uint32
    pEvents: pointer
struct MFT_OUTPUT_DATA_BUFFER
{
    uint dwStreamID;
    void* pSample;
    uint dwStatus;
    void* pEvents;
}

HSP用 定義

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

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

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