ホーム › Media.Multimedia › ICSeqCompressFrameStart

ICSeqCompressFrameStart

関数

連続フレーム圧縮の開始準備を行う。

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

シグネチャ

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

BOOL ICSeqCompressFrameStart(
    COMPVARS* pc,
    BITMAPINFO* lpbiIn
);

パラメーター

名前	型	方向	説明
pc	COMPVARS*	in	圧縮用の情報で初期化された COMPVARS 構造体へのポインター。
lpbiIn	BITMAPINFO*	in	圧縮するデータの形式。

戻り値の型: BOOL

公式ドキュメント

ICSeqCompressFrameStart 関数は、ICSeqCompressFrame 関数を使用してフレームのシーケンスを圧縮するためのリソースを初期化します。

戻り値

成功した場合は TRUE、それ以外の場合は FALSE を返します。

解説(Remarks)

この関数は COMPVARS 構造体を使用して指定したコンプレッサーの設定を提供し、COMPVARS の lKey メンバーで指定されたレートでキーフレームを挿入します。COMPVARS の該当するメンバーを使用して、シーケンスのデータレートとキーフレームの頻度の値を指定できます。

ICSeqCompressFrameStart、ICSeqCompressFrame、および ICSeqCompressFrameEnd 関数を使用すると、フレームのシーケンスを指定したデータレートおよびキーフレーム数に圧縮できます。

圧縮が完了したら、ICCompressorFree 関数を使用して COMPVARS で指定したリソースを解放します。

COMPVARS は、この関数を使用する前に初期化しておく必要があります。構造体を手動で初期化することも、ICCompressorChoose 関数を使用してユーザーにコンプレッサーを指定させ COMPVARS 構造体を初期化させることもできます。

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

各言語での呼び出し定義

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

BOOL ICSeqCompressFrameStart(
    COMPVARS* pc,
    BITMAPINFO* lpbiIn
);

[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll", ExactSpelling = true)]
static extern bool ICSeqCompressFrameStart(
    IntPtr pc,   // COMPVARS*
    IntPtr lpbiIn   // BITMAPINFO*
);

<DllImport("MSVFW32.dll", ExactSpelling:=True)>
Public Shared Function ICSeqCompressFrameStart(
    pc As IntPtr,   ' COMPVARS*
    lpbiIn As IntPtr   ' BITMAPINFO*
) As <MarshalAs(UnmanagedType.Bool)> Boolean
End Function

' pc : COMPVARS*
' lpbiIn : BITMAPINFO*
Declare PtrSafe Function ICSeqCompressFrameStart Lib "msvfw32" ( _
    ByVal pc As LongPtr, _
    ByVal lpbiIn As LongPtr) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。

import ctypes
from ctypes import wintypes

ICSeqCompressFrameStart = ctypes.windll.msvfw32.ICSeqCompressFrameStart
ICSeqCompressFrameStart.restype = wintypes.BOOL
ICSeqCompressFrameStart.argtypes = [
    ctypes.c_void_p,  # pc : COMPVARS*
    ctypes.c_void_p,  # lpbiIn : BITMAPINFO*
]

require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MSVFW32.dll')
ICSeqCompressFrameStart = Fiddle::Function.new(
  lib['ICSeqCompressFrameStart'],
  [
    Fiddle::TYPE_VOIDP,  # pc : COMPVARS*
    Fiddle::TYPE_VOIDP,  # lpbiIn : BITMAPINFO*
  ],
  Fiddle::TYPE_INT)

#[link(name = "msvfw32")]
extern "system" {
    fn ICSeqCompressFrameStart(
        pc: *mut COMPVARS,  // COMPVARS*
        lpbiIn: *mut BITMAPINFO  // BITMAPINFO*
    ) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.

$sig = @"
[return: MarshalAs(UnmanagedType.Bool)]
[DllImport("MSVFW32.dll")]
public static extern bool ICSeqCompressFrameStart(IntPtr pc, IntPtr lpbiIn);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSVFW32_ICSeqCompressFrameStart' -Namespace Win32 -PassThru
# $api::ICSeqCompressFrameStart(pc, lpbiIn)

#uselib "MSVFW32.dll"
#func global ICSeqCompressFrameStart "ICSeqCompressFrameStart" sptr, sptr
; ICSeqCompressFrameStart varptr(pc), varptr(lpbiIn)   ; 戻り値は stat
; pc : COMPVARS* -> "sptr"
; lpbiIn : BITMAPINFO* -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。

出力引数:

#uselib "MSVFW32.dll"
#cfunc global ICSeqCompressFrameStart "ICSeqCompressFrameStart" var, var
; res = ICSeqCompressFrameStart(pc, lpbiIn)
; pc : COMPVARS* -> "var"
; lpbiIn : BITMAPINFO* -> "var"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "MSVFW32.dll"
#cfunc global ICSeqCompressFrameStart "ICSeqCompressFrameStart" sptr, sptr
; res = ICSeqCompressFrameStart(varptr(pc), varptr(lpbiIn))
; pc : COMPVARS* -> "sptr"
; lpbiIn : BITMAPINFO* -> "sptr"
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。