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

AVISUPERINDEX

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

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

フィールド

フィールド型サイズx64x86説明
fccDWORD4+0+0FOURCC コードです。値は 'indx' でなければなりません。
cbDWORD4+4+4構造体のサイズです。先頭の 8 バイトは含みません。
wLongsPerEntryWORD2+8+8各インデックスエントリのサイズ (4 バイト単位) です。値は 4 でなければなりません。
bIndexSubTypeBYTE1+10+10インデックスのサブタイプです。値は 0 または AVI_INDEX_SUB_2FIELD でなければなりません。
bIndexTypeBYTE1+11+11インデックスの種類です。値は AVI_INDEX_OF_INDEXES でなければなりません。
nEntriesInUseDWORD4+12+12adwIndex 配列内の有効なエントリの数です。
dwChunkIdDWORD4+16+16インデックスの対象となるオブジェクトを識別する FOURCC です。
dwReservedDWORD12+20+20予約済みです。配列の要素は 0 に設定します。
aIndex_avisuperindex_entry16352+32+32

次のメンバーを含む構造体の配列です。配列の要素数は cb の値から計算されます。

qwOffset

このエントリが指すサブインデックスへの、ファイル先頭からのオフセット (バイト単位) です。

dwSize

サブインデックスのサイズ (バイト単位) です。

dwDuration

サブインデックスが対象とするファイルの再生時間 (ストリームティック単位) です。

構造体: _avisuperindex_entry x64 16B / x86 16B

フィールド型サイズx64x86
qwOffsetULONGLONG8+0+0
dwSizeDWORD4+8+8
dwDurationDWORD4+12+12

公式ドキュメント

[このページに関連する機能である DirectShow はレガシー機能です。この機能は MediaPlayer、IMFMediaEngine、および Audio/Video Capture in Media Foundation に置き換えられました。これらの機能は Windows 10 および Windows 11 向けに最適化されています。可能な場合、新しいコードでは DirectShow ではなく MediaPlayer、IMFMediaEngine、Audio/Video Capture in Media Foundation を使用することを Microsoft は強く推奨します。レガシー 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>

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

[StructLayout(LayoutKind.Sequential, Pack = 2, CharSet = CharSet.Unicode)]
public struct AVISUPERINDEX
{
    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 = 1022)] public _avisuperindex_entry[] aIndex;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=2, CharSet:=CharSet.Unicode)>
Public Structure AVISUPERINDEX
    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:=1022)> Public aIndex() As _avisuperindex_entry
End Structure
import ctypes
from ctypes import wintypes

class AVISUPERINDEX(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),
        ("aIndex", _avisuperindex_entry * 1022),
    ]
#[repr(C, packed(2))]
pub struct AVISUPERINDEX {
    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 aIndex: [_avisuperindex_entry; 1022],
}
import "golang.org/x/sys/windows"

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

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AVISUPERINDEX サイズ: 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 も可)
; dwReserved : DWORD (+20, 12byte)  varptr(st)+20 を基点に操作(12byte:入れ子/配列)
; aIndex : _avisuperindex_entry (+32, 16352byte)  varptr(st)+32 を基点に操作(16352byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AVISUPERINDEX, 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 _avisuperindex_entry aIndex 1022
#endstruct

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