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

AVIMETAINDEX

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 36 バイト / x86: 36 バイトパッキング2

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

フィールド

フィールド型サイズx64x86説明
fccDWORD4+0+0FOURCC コードです。値は 'indx' または 'nnix' のいずれかで、nn はストリーム番号です。
cbDWORD4+4+4構造体のサイズです。先頭の 8 バイトは含みません。
wLongsPerEntryWORD2+8+8各インデックスエントリのサイズを 4 バイト単位で指定します。
bIndexSubTypeBYTE1+10+10インデックスのサブタイプです。意味は bIndexType の値によって異なります。
bIndexTypeBYTE1+11+11

インデックスの種類です。

Value Meaning
AVI_INDEX_OF_INDEXES
0x00
 各インデックスエントリは別のインデックスを指します。AVIMETAINDEX 構造体を AVISUPERINDEX 構造体として扱います。bIndexSubType の値は 0 でなければなりません。
AVI_INDEX_OF_CHUNKS
0x01
 各インデックスエントリはファイル内のデータチャンクを指します。
  • bIndexSubType が 0 の場合、AVIMETAINDEX 構造体を AVISTDINDEX 構造体として扱います。各インデックスエントリは AVISTDINDEX_ENTRY 構造体です。
  • bIndexSubType が AVI_INDEX_SUB_2FIELD の場合、インデックスはフィールドインデックスチャンクです。
    注意 DirectShow はフィールドインデックスをサポートしていません。
AVI_INDEX_IS_DATA
0x80
 adwIndex 配列には、インデックスエントリのリストではなくデータのテーブルが格納されます。
nEntriesInUseDWORD4+12+12adwIndex 配列内の有効なエントリの数です。
dwChunkIdDWORD4+16+16インデックス対象のオブジェクトを識別する FOURCC です。インデックス対象のオブジェクトがストリームの場合、このメンバーは AVIOLDINDEX 構造体の dwChunkId メンバーと同じ意味を持ちます。
dwReservedDWORD12+20+20このメンバーの意味はインデックスの種類によって異なります。
adwIndexDWORD4+32+32インデックスエントリの配列です。このデータの形式はインデックスの種類によって異なります。

公式ドキュメント

[このページに関連する機能である DirectShow はレガシー機能です。これは MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられています。これらの機能は Windows 10 および Windows 11 向けに最適化されています。Microsoft は、新しいコードでは可能な限り DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを強く推奨します。また、レガシー API を使用している既存のコードについても、可能であれば新しい API を使用するように書き換えることを推奨します。]

AVI 2.0 インデックス ('indx' 形式) の基本構造体です。

解説(Remarks)

詳細については、OpenDML AVI M-JPEG File Format Subcommittee が発行している OpenDML AVI File Format Extensions を参照してください。(このリソースは一部の言語および国では利用できない場合があります。)

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

各言語での定義

#include <windows.h>

// AVIMETAINDEX  (x64 36 / x86 36 バイト)
#pragma pack(push, 2)
typedef struct AVIMETAINDEX {
    DWORD fcc;
    DWORD cb;
    WORD wLongsPerEntry;
    BYTE bIndexSubType;
    BYTE bIndexType;
    DWORD nEntriesInUse;
    DWORD dwChunkId;
    DWORD dwReserved[3];
    DWORD adwIndex[1];
} AVIMETAINDEX;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct AVIMETAINDEX
{
    public uint fcc;
    public uint cb;
    public ushort wLongsPerEntry;
    public byte bIndexSubType;
    public byte bIndexType;
    public uint nEntriesInUse;
    public uint dwChunkId;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)] public uint[] dwReserved;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public uint[] adwIndex;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure AVIMETAINDEX
    Public fcc As UInteger
    Public cb As UInteger
    Public wLongsPerEntry As UShort
    Public bIndexSubType As Byte
    Public bIndexType As Byte
    Public nEntriesInUse As UInteger
    Public dwChunkId As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=3)> Public dwReserved() As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public adwIndex() As UInteger
End Structure
import ctypes
from ctypes import wintypes

class AVIMETAINDEX(ctypes.Structure):
    _pack_ = 2
    _fields_ = [
        ("fcc", wintypes.DWORD),
        ("cb", wintypes.DWORD),
        ("wLongsPerEntry", ctypes.c_ushort),
        ("bIndexSubType", ctypes.c_ubyte),
        ("bIndexType", ctypes.c_ubyte),
        ("nEntriesInUse", wintypes.DWORD),
        ("dwChunkId", wintypes.DWORD),
        ("dwReserved", wintypes.DWORD * 3),
        ("adwIndex", wintypes.DWORD * 1),
    ]
#[repr(C, packed(2))]
pub struct AVIMETAINDEX {
    pub fcc: u32,
    pub cb: u32,
    pub wLongsPerEntry: u16,
    pub bIndexSubType: u8,
    pub bIndexType: u8,
    pub nEntriesInUse: u32,
    pub dwChunkId: u32,
    pub dwReserved: [u32; 3],
    pub adwIndex: [u32; 1],
}
import "golang.org/x/sys/windows"

type AVIMETAINDEX struct {
	fcc uint32
	cb uint32
	wLongsPerEntry uint16
	bIndexSubType byte
	bIndexType byte
	nEntriesInUse uint32
	dwChunkId uint32
	dwReserved [3]uint32
	adwIndex [1]uint32
}
type
  AVIMETAINDEX = packed record
    fcc: DWORD;
    cb: DWORD;
    wLongsPerEntry: Word;
    bIndexSubType: Byte;
    bIndexType: Byte;
    nEntriesInUse: DWORD;
    dwChunkId: DWORD;
    dwReserved: array[0..2] of DWORD;
    adwIndex: array[0..0] of DWORD;
  end;
const AVIMETAINDEX = extern struct {
    fcc: u32,
    cb: u32,
    wLongsPerEntry: u16,
    bIndexSubType: u8,
    bIndexType: u8,
    nEntriesInUse: u32,
    dwChunkId: u32,
    dwReserved: [3]u32,
    adwIndex: [1]u32,
};
type
  AVIMETAINDEX {.packed.} = object
    fcc: uint32
    cb: uint32
    wLongsPerEntry: uint16
    bIndexSubType: uint8
    bIndexType: uint8
    nEntriesInUse: uint32
    dwChunkId: uint32
    dwReserved: array[3, uint32]
    adwIndex: array[1, uint32]
align(2)
struct AVIMETAINDEX
{
    uint fcc;
    uint cb;
    ushort wLongsPerEntry;
    ubyte bIndexSubType;
    ubyte bIndexType;
    uint nEntriesInUse;
    uint dwChunkId;
    uint[3] dwReserved;
    uint[1] adwIndex;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AVIMETAINDEX サイズ: 36 バイト(x64)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; fcc : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; cb : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; wLongsPerEntry : WORD (+8, 2byte)  wpoke st,8,値  /  値 = wpeek(st,8)
; bIndexSubType : BYTE (+10, 1byte)  poke st,10,値  /  値 = peek(st,10)
; bIndexType : BYTE (+11, 1byte)  poke st,11,値  /  値 = peek(st,11)
; nEntriesInUse : DWORD (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; dwChunkId : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; dwReserved : DWORD (+20, 12byte)  varptr(st)+20 を基点に操作(12byte:入れ子/配列)
; adwIndex : DWORD (+32, 4byte)  varptr(st)+32 を基点に操作(4byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AVIMETAINDEX, pack=2
    #field int fcc
    #field int cb
    #field short wLongsPerEntry
    #field byte bIndexSubType
    #field byte bIndexType
    #field int nEntriesInUse
    #field int dwChunkId
    #field int dwReserved 3
    #field int adwIndex 1
#endstruct

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