ホーム › Media.Multimedia › ICSeqCompressFrame

ICSeqCompressFrame

関数

連続シーケンス内の1フレームを圧縮する。

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

シグネチャ

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

void* ICSeqCompressFrame(
    COMPVARS* pc,
    DWORD uiFlags,   // optional
    void* lpBits,
    BOOL* pfKey,
    INT* plSize   // optional
);

パラメーター

名前	型	方向	説明
pc	COMPVARS*	in	圧縮に関する情報で初期化された COMPVARS 構造体へのポインターです。
uiFlags	DWORD	optional	予約済みです。0 を指定する必要があります。
lpBits	void*	in	圧縮するデータビットへのポインターです。(データビットにはヘッダー情報やフォーマット情報は含まれません。)
pfKey	BOOL*	out	フレームがキーフレームに圧縮されたかどうかを返します。
plSize	INT*	inoutoptional	圧縮後の画像に望むサイズの最大値です。圧縮器がこのサイズに収まるようデータを圧縮できない場合があります。関数が返るとき、このパラメーターは圧縮後の画像のサイズを指します。画像サイズはバイト単位で指定します。

戻り値の型: void*

公式ドキュメント

ICSeqCompressFrame 関数は、一連のフレームのうち 1 フレームを圧縮します。

戻り値

成功した場合は圧縮されたビットのアドレスを返し、それ以外の場合は NULL を返します。

解説(Remarks)

この関数は COMPVARS 構造体を使用して、指定した圧縮器に対する設定を提供し、ICSeqCompressorFrameStart 関数で指定したレートでキーフレームを挿入します。シーケンスのデータレートやキーフレームの頻度の値は、COMPVARS の適切なメンバーを使用して指定できます。

ビデオシーケンスを圧縮するには、ICCompress 関数ではなくこの関数を使用してください。

ICCompressorChoose 関数を使用すると、ユーザーに圧縮器を指定させ、COMPVARS 構造体を初期化できます。あるいは、COMPVARS 構造体を手動で初期化することもできます。

指定したデータレートおよびキーフレーム数で一連のフレームを圧縮するには、ICSeqCompressFrameStart、ICSeqCompressFrame、および ICSeqCompressFrameEnd 関数を使用します。圧縮するフレームごとに ICSeqCompressFrame を 1 回使用してください。

圧縮が終了したら、ICCompressorFree 関数を使用して、COMPVARS によって指定されたリソースを解放してください。

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

各言語での呼び出し定義

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

void* ICSeqCompressFrame(
    COMPVARS* pc,
    DWORD uiFlags,   // optional
    void* lpBits,
    BOOL* pfKey,
    INT* plSize   // optional
);

[DllImport("MSVFW32.dll", ExactSpelling = true)]
static extern IntPtr ICSeqCompressFrame(
    IntPtr pc,   // COMPVARS*
    uint uiFlags,   // DWORD optional
    IntPtr lpBits,   // void*
    out bool pfKey,   // BOOL* out
    IntPtr plSize   // INT* optional, in/out
);

<DllImport("MSVFW32.dll", ExactSpelling:=True)>
Public Shared Function ICSeqCompressFrame(
    pc As IntPtr,   ' COMPVARS*
    uiFlags As UInteger,   ' DWORD optional
    lpBits As IntPtr,   ' void*
    <Out> ByRef pfKey As Boolean,   ' BOOL* out
    plSize As IntPtr   ' INT* optional, in/out
) As IntPtr
End Function

' pc : COMPVARS*
' uiFlags : DWORD optional
' lpBits : void*
' pfKey : BOOL* out
' plSize : INT* optional, in/out
Declare PtrSafe Function ICSeqCompressFrame Lib "msvfw32" ( _
    ByVal pc As LongPtr, _
    ByVal uiFlags As Long, _
    ByVal lpBits As LongPtr, _
    ByRef pfKey As Long, _
    ByVal plSize As LongPtr) As LongPtr
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

ICSeqCompressFrame = ctypes.windll.msvfw32.ICSeqCompressFrame
ICSeqCompressFrame.restype = ctypes.c_void_p
ICSeqCompressFrame.argtypes = [
    ctypes.c_void_p,  # pc : COMPVARS*
    wintypes.DWORD,  # uiFlags : DWORD optional
    ctypes.POINTER(None),  # lpBits : void*
    ctypes.c_void_p,  # pfKey : BOOL* out
    ctypes.POINTER(ctypes.c_int),  # plSize : INT* optional, in/out
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MSVFW32.dll')
ICSeqCompressFrame = Fiddle::Function.new(
  lib['ICSeqCompressFrame'],
  [
    Fiddle::TYPE_VOIDP,  # pc : COMPVARS*
    -Fiddle::TYPE_INT,  # uiFlags : DWORD optional
    Fiddle::TYPE_VOIDP,  # lpBits : void*
    Fiddle::TYPE_VOIDP,  # pfKey : BOOL* out
    Fiddle::TYPE_VOIDP,  # plSize : INT* optional, in/out
  ],
  Fiddle::TYPE_VOIDP)

#[link(name = "msvfw32")]
extern "system" {
    fn ICSeqCompressFrame(
        pc: *mut COMPVARS,  // COMPVARS*
        uiFlags: u32,  // DWORD optional
        lpBits: *mut (),  // void*
        pfKey: *mut i32,  // BOOL* out
        plSize: *mut i32  // INT* optional, in/out
    ) -> *mut ();
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[DllImport("MSVFW32.dll")]
public static extern IntPtr ICSeqCompressFrame(IntPtr pc, uint uiFlags, IntPtr lpBits, out bool pfKey, IntPtr plSize);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSVFW32_ICSeqCompressFrame' -Namespace Win32 -PassThru
# $api::ICSeqCompressFrame(pc, uiFlags, lpBits, pfKey, plSize)

#uselib "MSVFW32.dll"
#func global ICSeqCompressFrame "ICSeqCompressFrame" sptr, sptr, sptr, sptr, sptr
; ICSeqCompressFrame varptr(pc), uiFlags, lpBits, varptr(pfKey), varptr(plSize)   ; 戻り値は stat
; pc : COMPVARS* -> "sptr"
; uiFlags : DWORD optional -> "sptr"
; lpBits : void* -> "sptr"
; pfKey : BOOL* out -> "sptr"
; plSize : INT* optional, in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MSVFW32.dll"
#cfunc global ICSeqCompressFrame "ICSeqCompressFrame" var, int, sptr, var, var
; res = ICSeqCompressFrame(pc, uiFlags, lpBits, pfKey, plSize)
; pc : COMPVARS* -> "var"
; uiFlags : DWORD optional -> "int"
; lpBits : void* -> "sptr"
; pfKey : BOOL* out -> "var"
; plSize : INT* optional, in/out -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MSVFW32.dll"
#cfunc global ICSeqCompressFrame "ICSeqCompressFrame" sptr, int, sptr, sptr, sptr
; res = ICSeqCompressFrame(varptr(pc), uiFlags, lpBits, varptr(pfKey), varptr(plSize))
; pc : COMPVARS* -> "sptr"
; uiFlags : DWORD optional -> "int"
; lpBits : void* -> "sptr"
; pfKey : BOOL* out -> "sptr"
; plSize : INT* optional, in/out -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。