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

COMPVARS

構造体
サイズx64: 96 バイト / x86: 64 バイト

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

フィールド

フィールドサイズx64x86説明
cbSizeINT4+0+0この構造体のサイズ (バイト単位)。この構造体を使用する関数を呼び出す前に、構造体を有効にするためこのメンバーを設定しなければなりません。
dwFlagsDWORD4+4+4

適用するフラグ。次の値が定義されています。

名前 説明
ICMF_COMPVARS_VALID
この構造体のデータは有効であり、手動で入力されています。この構造体を手動で設定する場合は、いずれかの関数を呼び出す前にこのフラグを設定してください。ICCompressorChoose にこの構造体を初期化させる場合は、このフラグを設定しないでください。
hicHIC8/4+8+8使用するコンプレッサーへのハンドル。ICOpen 関数を使用してコンプレッサーを開き、そのハンドルを取得できます。また、ICCompressorChoose を使用してコンプレッサーを選択することもできます。ICCompressorChoose は選択されたコンプレッサーを開き、そのコンプレッサーのハンドルをこのメンバーに返します。コンプレッサーは ICCompressorFree を使用して閉じることができます。
fccTypeDWORD4+16+12使用するコンプレッサーの種類。現在は ICTYPE_VIDEO (VIDC) のみがサポートされています。このメンバーには 0 を設定できます。
fccHandlerDWORD4+20+16コンプレッサーの 4 文字コード (FOURCC)。データを再圧縮しないことを示すには NULL を指定します。データが非圧縮のフルフレームであることを示すには "DIB" を指定します。このメンバーを使用して、ダイアログ ボックスの表示時に既定で選択されるコンプレッサーを指定できます。
lpbiInBITMAPINFO*8/4+24+20予約済みです。使用しないでください。
lpbiOutBITMAPINFO*8/4+32+24画像の出力形式を格納する BITMAPINFO 構造体へのポインター。使用する特定の形式を指定するか、入力形式に関連付けられた既定のコンプレッサーを使用するために NULL を指定できます。画像の出力形式は ICCompressorChoose を使用して設定することもできます。
lpBitsOutvoid*8/4+40+28予約済みです。使用しないでください。
lpBitsPrevvoid*8/4+48+32予約済みです。使用しないでください。
lFrameINT4+56+36予約済みです。使用しないでください。
lKeyINT4+60+40キーフレーム レート。圧縮されたシーケンス内でキーフレームが発生する頻度を示す整数を指定します。キーフレームを使用しない場合は 0 を指定します。ダイアログ ボックスで選択されたキーフレーム レートを ICCompressorChoose に設定させることもできます。ICSeqCompressFrameStart 関数は、キーフレームの作成にこのメンバーの値を使用します。
lDataRateINT4+64+44データ レート (1 秒あたりのキロバイト単位)。ICCompressorChoose は、ダイアログ ボックスで選択されたデータ レートをこのメンバーにコピーします。
lQINT4+68+48品質の設定。1 から 10,000 までの品質設定を指定するか、既定の品質設定を使用する場合は ICQUALITY_DEFAULT を指定します。ダイアログ ボックスで選択された品質値を ICCompressorChoose に設定させることもできます。ICSeqCompressFrameStart は、このメンバーの値を品質設定として使用します。
lKeyCountINT4+72+52予約済みです。使用しないでください。
lpStatevoid*8/4+80+56予約済みです。使用しないでください。
cbStateINT4+88+60予約済みです。使用しないでください。

公式ドキュメント

COMPVARS 構造体は、ICCompressorChooseICSeqCompressFrameICCompressorFree などの関数で使用するコンプレッサーの設定を記述します。

解説(Remarks)

この構造体の内容は ICCompressorChoose に設定させることも、手動で設定することもできます。手動で設定する場合は、cbSizehiclpbiOutlKeylQ の各メンバーに情報を指定しなければなりません。また、dwFlags メンバーに ICMF_COMPVARS_VALID フラグを設定する必要があります。

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

各言語での定義

#include <windows.h>

// COMPVARS  (x64 96 / x86 64 バイト)
typedef struct COMPVARS {
    INT cbSize;
    DWORD dwFlags;
    HIC hic;
    DWORD fccType;
    DWORD fccHandler;
    BITMAPINFO* lpbiIn;
    BITMAPINFO* lpbiOut;
    void* lpBitsOut;
    void* lpBitsPrev;
    INT lFrame;
    INT lKey;
    INT lDataRate;
    INT lQ;
    INT lKeyCount;
    void* lpState;
    INT cbState;
} COMPVARS;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct COMPVARS
{
    public int cbSize;
    public uint dwFlags;
    public IntPtr hic;
    public uint fccType;
    public uint fccHandler;
    public IntPtr lpbiIn;
    public IntPtr lpbiOut;
    public IntPtr lpBitsOut;
    public IntPtr lpBitsPrev;
    public int lFrame;
    public int lKey;
    public int lDataRate;
    public int lQ;
    public int lKeyCount;
    public IntPtr lpState;
    public int cbState;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure COMPVARS
    Public cbSize As Integer
    Public dwFlags As UInteger
    Public hic As IntPtr
    Public fccType As UInteger
    Public fccHandler As UInteger
    Public lpbiIn As IntPtr
    Public lpbiOut As IntPtr
    Public lpBitsOut As IntPtr
    Public lpBitsPrev As IntPtr
    Public lFrame As Integer
    Public lKey As Integer
    Public lDataRate As Integer
    Public lQ As Integer
    Public lKeyCount As Integer
    Public lpState As IntPtr
    Public cbState As Integer
End Structure
import ctypes
from ctypes import wintypes

class COMPVARS(ctypes.Structure):
    _fields_ = [
        ("cbSize", ctypes.c_int),
        ("dwFlags", wintypes.DWORD),
        ("hic", ctypes.c_void_p),
        ("fccType", wintypes.DWORD),
        ("fccHandler", wintypes.DWORD),
        ("lpbiIn", ctypes.c_void_p),
        ("lpbiOut", ctypes.c_void_p),
        ("lpBitsOut", ctypes.c_void_p),
        ("lpBitsPrev", ctypes.c_void_p),
        ("lFrame", ctypes.c_int),
        ("lKey", ctypes.c_int),
        ("lDataRate", ctypes.c_int),
        ("lQ", ctypes.c_int),
        ("lKeyCount", ctypes.c_int),
        ("lpState", ctypes.c_void_p),
        ("cbState", ctypes.c_int),
    ]
#[repr(C)]
pub struct COMPVARS {
    pub cbSize: i32,
    pub dwFlags: u32,
    pub hic: *mut core::ffi::c_void,
    pub fccType: u32,
    pub fccHandler: u32,
    pub lpbiIn: *mut core::ffi::c_void,
    pub lpbiOut: *mut core::ffi::c_void,
    pub lpBitsOut: *mut core::ffi::c_void,
    pub lpBitsPrev: *mut core::ffi::c_void,
    pub lFrame: i32,
    pub lKey: i32,
    pub lDataRate: i32,
    pub lQ: i32,
    pub lKeyCount: i32,
    pub lpState: *mut core::ffi::c_void,
    pub cbState: i32,
}
import "golang.org/x/sys/windows"

type COMPVARS struct {
	cbSize int32
	dwFlags uint32
	hic uintptr
	fccType uint32
	fccHandler uint32
	lpbiIn uintptr
	lpbiOut uintptr
	lpBitsOut uintptr
	lpBitsPrev uintptr
	lFrame int32
	lKey int32
	lDataRate int32
	lQ int32
	lKeyCount int32
	lpState uintptr
	cbState int32
}
type
  COMPVARS = record
    cbSize: Integer;
    dwFlags: DWORD;
    hic: Pointer;
    fccType: DWORD;
    fccHandler: DWORD;
    lpbiIn: Pointer;
    lpbiOut: Pointer;
    lpBitsOut: Pointer;
    lpBitsPrev: Pointer;
    lFrame: Integer;
    lKey: Integer;
    lDataRate: Integer;
    lQ: Integer;
    lKeyCount: Integer;
    lpState: Pointer;
    cbState: Integer;
  end;
const COMPVARS = extern struct {
    cbSize: i32,
    dwFlags: u32,
    hic: ?*anyopaque,
    fccType: u32,
    fccHandler: u32,
    lpbiIn: ?*anyopaque,
    lpbiOut: ?*anyopaque,
    lpBitsOut: ?*anyopaque,
    lpBitsPrev: ?*anyopaque,
    lFrame: i32,
    lKey: i32,
    lDataRate: i32,
    lQ: i32,
    lKeyCount: i32,
    lpState: ?*anyopaque,
    cbState: i32,
};
type
  COMPVARS {.bycopy.} = object
    cbSize: int32
    dwFlags: uint32
    hic: pointer
    fccType: uint32
    fccHandler: uint32
    lpbiIn: pointer
    lpbiOut: pointer
    lpBitsOut: pointer
    lpBitsPrev: pointer
    lFrame: int32
    lKey: int32
    lDataRate: int32
    lQ: int32
    lKeyCount: int32
    lpState: pointer
    cbState: int32
struct COMPVARS
{
    int cbSize;
    uint dwFlags;
    void* hic;
    uint fccType;
    uint fccHandler;
    void* lpbiIn;
    void* lpbiOut;
    void* lpBitsOut;
    void* lpBitsPrev;
    int lFrame;
    int lKey;
    int lDataRate;
    int lQ;
    int lKeyCount;
    void* lpState;
    int cbState;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; COMPVARS サイズ: 64 バイト(x86)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; cbSize : INT (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hic : HIC (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; fccType : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; fccHandler : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; lpbiIn : BITMAPINFO* (+20, 4byte)  varptr(st)+20 を基点に操作(4byte:入れ子/配列)
; lpbiOut : BITMAPINFO* (+24, 4byte)  varptr(st)+24 を基点に操作(4byte:入れ子/配列)
; lpBitsOut : void* (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lpBitsPrev : void* (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; lFrame : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lKey : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lDataRate : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; lQ : INT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; lKeyCount : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; lpState : void* (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; cbState : INT (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; COMPVARS サイズ: 96 バイト(x64)
dim st, 24    ; 4byte整数×24(構造体サイズ 96 / 4 切り上げ)
; cbSize : INT (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hic : HIC (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; fccType : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; fccHandler : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; lpbiIn : BITMAPINFO* (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; lpbiOut : BITMAPINFO* (+32, 8byte)  varptr(st)+32 を基点に操作(8byte:入れ子/配列)
; lpBitsOut : void* (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; lpBitsPrev : void* (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; lFrame : INT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; lKey : INT (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; lDataRate : INT (+64, 4byte)  st.16 = 値  /  値 = st.16   (lpoke/lpeek も可)
; lQ : INT (+68, 4byte)  st.17 = 値  /  値 = st.17   (lpoke/lpeek も可)
; lKeyCount : INT (+72, 4byte)  st.18 = 値  /  値 = st.18   (lpoke/lpeek も可)
; lpState : void* (+80, 8byte)  qpoke st,80,値 / qpeek(st,80)  ※IronHSPのみ。3.7/3.8は lpoke st,80,下位 : lpoke st,84,上位
; cbState : INT (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global COMPVARS
    #field int cbSize
    #field int dwFlags
    #field intptr hic
    #field int fccType
    #field int fccHandler
    #field intptr lpbiIn
    #field intptr lpbiOut
    #field intptr lpBitsOut
    #field intptr lpBitsPrev
    #field int lFrame
    #field int lKey
    #field int lDataRate
    #field int lQ
    #field int lKeyCount
    #field intptr lpState
    #field int cbState
#endstruct

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