ホーム › Media.Multimedia › EditStreamPaste

EditStreamPaste

関数

別ストリームのデータを編集可能ストリームの指定位置へ貼り付ける。

DLLAVIFIL32.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

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

HRESULT EditStreamPaste(
    IAVIStream* pavi,
    INT* plPos,
    INT* plLength,
    IAVIStream* pstream,
    INT lStart,
    INT lEnd
);

パラメーター

名前	型	方向	説明
pavi	IAVIStream*	in	コピーされたストリームデータを受け取る、編集可能なストリームへのハンドル。
plPos	INT*	inout	貼り付け先ストリーム(pavi で参照される)内で、データを貼り付ける開始位置。
plLength	INT*	inout	ストリームに貼り付けられたデータ量を受け取るバッファへのポインター。
pstream	IAVIStream*	in	貼り付けるデータを供給するストリームへのハンドル。このストリームは編集可能なストリームである必要はありません。
lStart	INT	in	コピー元ストリーム内で、コピーするデータの開始位置。
lEnd	INT	in	コピー元ストリームからコピーするデータ量。lLength が -1 の場合、pstream で参照されるストリーム全体が、もう一方のストリームに貼り付けられます。

戻り値の型: HRESULT

公式ドキュメント

EditStreamPaste 関数は、あるストリームからストリーム(またはその一部)をコピーし、別のストリーム内の指定した位置に貼り付けます。

戻り値

成功した場合は 0 を返し、それ以外の場合はエラーを返します。

解説(Remarks)

pavi で参照されるストリームは、CreateEditableStream 関数またはいずれかのストリーム編集関数によって作成されている必要があります。

この関数は、指定したストリームに連続したデータブロックとしてデータを挿入します。挿入位置で指定したデータストリームを開き、挿入位置に指定したストリームセグメントを貼り付け、挿入位置の後ろに続くストリームセグメントを、貼り付けられたセグメントの末尾に追加します。

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

各言語での呼び出し定義

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

HRESULT EditStreamPaste(
    IAVIStream* pavi,
    INT* plPos,
    INT* plLength,
    IAVIStream* pstream,
    INT lStart,
    INT lEnd
);

[DllImport("AVIFIL32.dll", ExactSpelling = true)]
static extern int EditStreamPaste(
    IntPtr pavi,   // IAVIStream*
    ref int plPos,   // INT* in/out
    ref int plLength,   // INT* in/out
    IntPtr pstream,   // IAVIStream*
    int lStart,   // INT
    int lEnd   // INT
);

<DllImport("AVIFIL32.dll", ExactSpelling:=True)>
Public Shared Function EditStreamPaste(
    pavi As IntPtr,   ' IAVIStream*
    ByRef plPos As Integer,   ' INT* in/out
    ByRef plLength As Integer,   ' INT* in/out
    pstream As IntPtr,   ' IAVIStream*
    lStart As Integer,   ' INT
    lEnd As Integer   ' INT
) As Integer
End Function

' pavi : IAVIStream*
' plPos : INT* in/out
' plLength : INT* in/out
' pstream : IAVIStream*
' lStart : INT
' lEnd : INT
Declare PtrSafe Function EditStreamPaste Lib "avifil32" ( _
    ByVal pavi As LongPtr, _
    ByRef plPos As Long, _
    ByRef plLength As Long, _
    ByVal pstream As LongPtr, _
    ByVal lStart As Long, _
    ByVal lEnd As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

EditStreamPaste = ctypes.windll.avifil32.EditStreamPaste
EditStreamPaste.restype = ctypes.c_int
EditStreamPaste.argtypes = [
    ctypes.c_void_p,  # pavi : IAVIStream*
    ctypes.POINTER(ctypes.c_int),  # plPos : INT* in/out
    ctypes.POINTER(ctypes.c_int),  # plLength : INT* in/out
    ctypes.c_void_p,  # pstream : IAVIStream*
    ctypes.c_int,  # lStart : INT
    ctypes.c_int,  # lEnd : INT
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('AVIFIL32.dll')
EditStreamPaste = Fiddle::Function.new(
  lib['EditStreamPaste'],
  [
    Fiddle::TYPE_VOIDP,  # pavi : IAVIStream*
    Fiddle::TYPE_VOIDP,  # plPos : INT* in/out
    Fiddle::TYPE_VOIDP,  # plLength : INT* in/out
    Fiddle::TYPE_VOIDP,  # pstream : IAVIStream*
    Fiddle::TYPE_INT,  # lStart : INT
    Fiddle::TYPE_INT,  # lEnd : INT
  ],
  Fiddle::TYPE_INT)

#[link(name = "avifil32")]
extern "system" {
    fn EditStreamPaste(
        pavi: *mut core::ffi::c_void,  // IAVIStream*
        plPos: *mut i32,  // INT* in/out
        plLength: *mut i32,  // INT* in/out
        pstream: *mut core::ffi::c_void,  // IAVIStream*
        lStart: i32,  // INT
        lEnd: i32  // INT
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("AVIFIL32.dll")]
public static extern int EditStreamPaste(IntPtr pavi, ref int plPos, ref int plLength, IntPtr pstream, int lStart, int lEnd);
"@
$api = Add-Type -MemberDefinition $sig -Name 'AVIFIL32_EditStreamPaste' -Namespace Win32 -PassThru
# $api::EditStreamPaste(pavi, plPos, plLength, pstream, lStart, lEnd)

#uselib "AVIFIL32.dll"
#func global EditStreamPaste "EditStreamPaste" sptr, sptr, sptr, sptr, sptr, sptr
; EditStreamPaste pavi, varptr(plPos), varptr(plLength), pstream, lStart, lEnd   ; 戻り値は stat
; pavi : IAVIStream* -> "sptr"
; plPos : INT* in/out -> "sptr"
; plLength : INT* in/out -> "sptr"
; pstream : IAVIStream* -> "sptr"
; lStart : INT -> "sptr"
; lEnd : INT -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "AVIFIL32.dll"
#cfunc global EditStreamPaste "EditStreamPaste" sptr, var, var, sptr, int, int
; res = EditStreamPaste(pavi, plPos, plLength, pstream, lStart, lEnd)
; pavi : IAVIStream* -> "sptr"
; plPos : INT* in/out -> "var"
; plLength : INT* in/out -> "var"
; pstream : IAVIStream* -> "sptr"
; lStart : INT -> "int"
; lEnd : INT -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "AVIFIL32.dll"
#cfunc global EditStreamPaste "EditStreamPaste" sptr, sptr, sptr, sptr, int, int
; res = EditStreamPaste(pavi, varptr(plPos), varptr(plLength), pstream, lStart, lEnd)
; pavi : IAVIStream* -> "sptr"
; plPos : INT* in/out -> "sptr"
; plLength : INT* in/out -> "sptr"
; pstream : IAVIStream* -> "sptr"
; lStart : INT -> "int"
; lEnd : INT -> "int"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。