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

MFCombineSamples

関数
2つのサンプルを最大長以内で1つに結合する。
DLLMFPlat.dll呼出規約winapi対応OSWindows 10 以降
📘 Microsoft Learn (日本語) · English

シグネチャ

// MFPlat.dll
#include <windows.h>

HRESULT MFCombineSamples(
    IMFSample* pSample,
    IMFSample* pSampleToAdd,
    DWORD dwMaxMergedDurationInMS,
    BOOL* pMerged
);

パラメーター

名前型方向説明
pSampleIMFSample*in結合先となるサンプルIMFSampleへのポインタ。結合結果がここに反映される。
pSampleToAddIMFSample*in結合先へ追加するサンプルIMFSampleへのポインタ。
dwMaxMergedDurationInMSDWORDin結合後に許容する最大合計時間長(ミリ秒)。これを超えると結合しない。
pMergedBOOL*out実際に結合できたか否かを受け取るBOOLへのポインタ。

戻り値の型: HRESULT

各言語での呼び出し定義

// MFPlat.dll
#include <windows.h>

HRESULT MFCombineSamples(
    IMFSample* pSample,
    IMFSample* pSampleToAdd,
    DWORD dwMaxMergedDurationInMS,
    BOOL* pMerged
);
[DllImport("MFPlat.dll", ExactSpelling = true)]
static extern int MFCombineSamples(
    IntPtr pSample,   // IMFSample*
    IntPtr pSampleToAdd,   // IMFSample*
    uint dwMaxMergedDurationInMS,   // DWORD
    out int pMerged   // BOOL* out
);
<DllImport("MFPlat.dll", ExactSpelling:=True)>
Public Shared Function MFCombineSamples(
    pSample As IntPtr,   ' IMFSample*
    pSampleToAdd As IntPtr,   ' IMFSample*
    dwMaxMergedDurationInMS As UInteger,   ' DWORD
    <Out> ByRef pMerged As Integer   ' BOOL* out
) As Integer
End Function
' pSample : IMFSample*
' pSampleToAdd : IMFSample*
' dwMaxMergedDurationInMS : DWORD
' pMerged : BOOL* out
Declare PtrSafe Function MFCombineSamples Lib "mfplat" ( _
    ByVal pSample As LongPtr, _
    ByVal pSampleToAdd As LongPtr, _
    ByVal dwMaxMergedDurationInMS As Long, _
    ByRef pMerged As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

MFCombineSamples = ctypes.windll.mfplat.MFCombineSamples
MFCombineSamples.restype = ctypes.c_int
MFCombineSamples.argtypes = [
    ctypes.c_void_p,  # pSample : IMFSample*
    ctypes.c_void_p,  # pSampleToAdd : IMFSample*
    wintypes.DWORD,  # dwMaxMergedDurationInMS : DWORD
    ctypes.c_void_p,  # pMerged : BOOL* out
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MFPlat.dll')
MFCombineSamples = Fiddle::Function.new(
  lib['MFCombineSamples'],
  [
    Fiddle::TYPE_VOIDP,  # pSample : IMFSample*
    Fiddle::TYPE_VOIDP,  # pSampleToAdd : IMFSample*
    -Fiddle::TYPE_INT,  # dwMaxMergedDurationInMS : DWORD
    Fiddle::TYPE_VOIDP,  # pMerged : BOOL* out
  ],
  Fiddle::TYPE_INT)
#[link(name = "mfplat")]
extern "system" {
    fn MFCombineSamples(
        pSample: *mut core::ffi::c_void,  // IMFSample*
        pSampleToAdd: *mut core::ffi::c_void,  // IMFSample*
        dwMaxMergedDurationInMS: u32,  // DWORD
        pMerged: *mut i32  // BOOL* out
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("MFPlat.dll")]
public static extern int MFCombineSamples(IntPtr pSample, IntPtr pSampleToAdd, uint dwMaxMergedDurationInMS, out int pMerged);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MFPlat_MFCombineSamples' -Namespace Win32 -PassThru
# $api::MFCombineSamples(pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged)
#uselib "MFPlat.dll"
#func global MFCombineSamples "MFCombineSamples" sptr, sptr, sptr, sptr
; MFCombineSamples pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged   ; 戻り値は stat
; pSample : IMFSample* -> "sptr"
; pSampleToAdd : IMFSample* -> "sptr"
; dwMaxMergedDurationInMS : DWORD -> "sptr"
; pMerged : BOOL* out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
#uselib "MFPlat.dll"
#cfunc global MFCombineSamples "MFCombineSamples" sptr, sptr, int, int
; res = MFCombineSamples(pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged)
; pSample : IMFSample* -> "sptr"
; pSampleToAdd : IMFSample* -> "sptr"
; dwMaxMergedDurationInMS : DWORD -> "int"
; pMerged : BOOL* out -> "int"
; HRESULT MFCombineSamples(IMFSample* pSample, IMFSample* pSampleToAdd, DWORD dwMaxMergedDurationInMS, BOOL* pMerged)
#uselib "MFPlat.dll"
#cfunc global MFCombineSamples "MFCombineSamples" intptr, intptr, int, int
; res = MFCombineSamples(pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged)
; pSample : IMFSample* -> "intptr"
; pSampleToAdd : IMFSample* -> "intptr"
; dwMaxMergedDurationInMS : DWORD -> "int"
; pMerged : BOOL* out -> "int"
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	mfplat = windows.NewLazySystemDLL("MFPlat.dll")
	procMFCombineSamples = mfplat.NewProc("MFCombineSamples")
)

// pSample (IMFSample*), pSampleToAdd (IMFSample*), dwMaxMergedDurationInMS (DWORD), pMerged (BOOL* out)
r1, _, err := procMFCombineSamples.Call(
	uintptr(pSample),
	uintptr(pSampleToAdd),
	uintptr(dwMaxMergedDurationInMS),
	uintptr(pMerged),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // HRESULT
function MFCombineSamples(
  pSample: Pointer;   // IMFSample*
  pSampleToAdd: Pointer;   // IMFSample*
  dwMaxMergedDurationInMS: DWORD;   // DWORD
  pMerged: Pointer   // BOOL* out
): Integer; stdcall;
  external 'MFPlat.dll' name 'MFCombineSamples';
result := DllCall("MFPlat\MFCombineSamples"
    , "Ptr", pSample   ; IMFSample*
    , "Ptr", pSampleToAdd   ; IMFSample*
    , "UInt", dwMaxMergedDurationInMS   ; DWORD
    , "Ptr", pMerged   ; BOOL* out
    , "Int")   ; return: HRESULT
●MFCombineSamples(pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged) = DLL("MFPlat.dll", "int MFCombineSamples(void*, void*, dword, void*)")
# 呼び出し: MFCombineSamples(pSample, pSampleToAdd, dwMaxMergedDurationInMS, pMerged)
# pSample : IMFSample* -> "void*"
# pSampleToAdd : IMFSample* -> "void*"
# dwMaxMergedDurationInMS : DWORD -> "dword"
# pMerged : BOOL* out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。