AVISTDINDEX

構造体

サイズx64: 16384 バイト / x86: 16384 バイトパッキング2

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

フィールド

フィールド	型	サイズ	x64	x86	説明
fcc	DWORD	4	+0	+0	FOURCC コードです。値は 'indx' または 'nnix' のいずれかで、nn はストリーム番号です。
cb	DWORD	4	+4	+4	構造体のサイズです。先頭の 8 バイトは含みません。
wLongsPerEntry	WORD	2	+8	+8	各インデックスエントリのサイズを 4 バイト単位で表します。値は 2 でなければなりません。
bIndexSubType	BYTE	1	+10	+10	インデックスのサブタイプです。値は 0 でなければなりません。
bIndexType	BYTE	1	+11	+11	インデックスの種類です。値は AVI_INDEX_OF_CHUNKS でなければなりません。
nEntriesInUse	DWORD	4	+12	+12	adwIndex 配列内の有効なエントリの数です。
dwChunkId	DWORD	4	+16	+16	インデックス付けの対象となるオブジェクトを識別する FOURCC です。このメンバーは AVIOLDINDEX 構造体の dwChunkId メンバーと同じ意味を持ちます。
qwBaseOffset	ULONGLONG	8	+20	+20	インデックスエントリの基準オフセットです。各インデックスエントリについて、qwBaseOffset + AVISTDINDEX_ENTRY.dwOffset が、ファイルの先頭からデータまでのオフセットを表します。
dwReserved_3	DWORD	4	+28	+28	予約済みです。0 を設定します。
aIndex	AVISTDINDEX_ENTRY	16352	+32	+32	AVISTDINDEX_ENTRY 構造体の配列です。配列の要素数は cb の値から算出されます。

公式ドキュメント

[このページに関連する機能である 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 標準インデックスを格納します。

解説(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>

// AVISTDINDEX_ENTRY  (x64 8 / x86 8 バイト)
#pragma pack(push, 2)
typedef struct AVISTDINDEX_ENTRY {
    DWORD dwOffset;
    DWORD dwSize;
} AVISTDINDEX_ENTRY;
#pragma pack(pop)

// AVISTDINDEX  (x64 16384 / x86 16384 バイト)
#pragma pack(push, 2)
typedef struct AVISTDINDEX {
    DWORD fcc;
    DWORD cb;
    WORD wLongsPerEntry;
    BYTE bIndexSubType;
    BYTE bIndexType;
    DWORD nEntriesInUse;
    DWORD dwChunkId;
    ULONGLONG qwBaseOffset;
    DWORD dwReserved_3;
    AVISTDINDEX_ENTRY aIndex[2044];
} AVISTDINDEX;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct AVISTDINDEX_ENTRY
{
    public uint dwOffset;
    public uint dwSize;
}

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct AVISTDINDEX
{
    public uint fcc;
    public uint cb;
    public ushort wLongsPerEntry;
    public byte bIndexSubType;
    public byte bIndexType;
    public uint nEntriesInUse;
    public uint dwChunkId;
    public ulong qwBaseOffset;
    public uint dwReserved_3;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 2044)] public AVISTDINDEX_ENTRY[] aIndex;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure AVISTDINDEX_ENTRY
    Public dwOffset As UInteger
    Public dwSize As UInteger
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure AVISTDINDEX
    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
    Public qwBaseOffset As ULong
    Public dwReserved_3 As UInteger
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=2044)> Public aIndex() As AVISTDINDEX_ENTRY
End Structure

import ctypes
from ctypes import wintypes

class AVISTDINDEX_ENTRY(ctypes.Structure):
    _pack_ = 2
    _fields_ = [
        ("dwOffset", wintypes.DWORD),
        ("dwSize", wintypes.DWORD),
    ]

class AVISTDINDEX(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),
        ("qwBaseOffset", ctypes.c_ulonglong),
        ("dwReserved_3", wintypes.DWORD),
        ("aIndex", AVISTDINDEX_ENTRY * 2044),
    ]

#[repr(C, packed(2))]
pub struct AVISTDINDEX_ENTRY {
    pub dwOffset: u32,
    pub dwSize: u32,
}

#[repr(C, packed(2))]
pub struct AVISTDINDEX {
    pub fcc: u32,
    pub cb: u32,
    pub wLongsPerEntry: u16,
    pub bIndexSubType: u8,
    pub bIndexType: u8,
    pub nEntriesInUse: u32,
    pub dwChunkId: u32,
    pub qwBaseOffset: u64,
    pub dwReserved_3: u32,
    pub aIndex: [AVISTDINDEX_ENTRY; 2044],
}

import "golang.org/x/sys/windows"

type AVISTDINDEX_ENTRY struct {
	dwOffset uint32
	dwSize uint32
}

type AVISTDINDEX struct {
	fcc uint32
	cb uint32
	wLongsPerEntry uint16
	bIndexSubType byte
	bIndexType byte
	nEntriesInUse uint32
	dwChunkId uint32
	qwBaseOffset uint64
	dwReserved_3 uint32
	aIndex [2044]AVISTDINDEX_ENTRY
}

type
  AVISTDINDEX_ENTRY = packed record
    dwOffset: DWORD;
    dwSize: DWORD;
  end;

  AVISTDINDEX = packed record
    fcc: DWORD;
    cb: DWORD;
    wLongsPerEntry: Word;
    bIndexSubType: Byte;
    bIndexType: Byte;
    nEntriesInUse: DWORD;
    dwChunkId: DWORD;
    qwBaseOffset: UInt64;
    dwReserved_3: DWORD;
    aIndex: array[0..2043] of AVISTDINDEX_ENTRY;
  end;

const AVISTDINDEX_ENTRY = extern struct {
    dwOffset: u32,
    dwSize: u32,
};

const AVISTDINDEX = extern struct {
    fcc: u32,
    cb: u32,
    wLongsPerEntry: u16,
    bIndexSubType: u8,
    bIndexType: u8,
    nEntriesInUse: u32,
    dwChunkId: u32,
    qwBaseOffset: u64,
    dwReserved_3: u32,
    aIndex: [2044]AVISTDINDEX_ENTRY,
};

type
  AVISTDINDEX_ENTRY {.packed.} = object
    dwOffset: uint32
    dwSize: uint32

  AVISTDINDEX {.packed.} = object
    fcc: uint32
    cb: uint32
    wLongsPerEntry: uint16
    bIndexSubType: uint8
    bIndexType: uint8
    nEntriesInUse: uint32
    dwChunkId: uint32
    qwBaseOffset: uint64
    dwReserved_3: uint32
    aIndex: array[2044, AVISTDINDEX_ENTRY]

align(2)
struct AVISTDINDEX_ENTRY
{
    uint dwOffset;
    uint dwSize;
}

align(2)
struct AVISTDINDEX
{
    uint fcc;
    uint cb;
    ushort wLongsPerEntry;
    ubyte bIndexSubType;
    ubyte bIndexType;
    uint nEntriesInUse;
    uint dwChunkId;
    ulong qwBaseOffset;
    uint dwReserved_3;
    AVISTDINDEX_ENTRY[2044] aIndex;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AVISTDINDEX サイズ: 16384 バイト(x64)
dim st, 4096    ; 4byte整数×4096(構造体サイズ 16384 / 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 も可)
; qwBaseOffset : ULONGLONG (+20, 8byte)  qpoke st,20,値 / qpeek(st,20)  ※IronHSPのみ。3.7/3.8は lpoke st,20,下位 : lpoke st,24,上位
; dwReserved_3 : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; aIndex : AVISTDINDEX_ENTRY (+32, 16352byte)  varptr(st)+32 を基点に操作(16352byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global AVISTDINDEX_ENTRY, pack=2
    #field int dwOffset
    #field int dwSize
#endstruct

#defstruct global AVISTDINDEX, pack=2
    #field int fcc
    #field int cb
    #field short wLongsPerEntry
    #field byte bIndexSubType
    #field byte bIndexType
    #field int nEntriesInUse
    #field int dwChunkId
    #field int64 qwBaseOffset
    #field int dwReserved_3
    #field AVISTDINDEX_ENTRY aIndex 2044
#endstruct

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