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

ASF_INDEX_DESCRIPTOR

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 92 バイト / x86: 92 バイト

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

フィールド

フィールド型サイズx64x86説明
IdentifierASF_INDEX_IDENTIFIER20+0+0インデックス種別とストリーム番号を示すASF_INDEX_IDENTIFIER。
cPerEntryBytesWORD2+20+20各インデックスエントリのバイト数。
szDescriptionWCHAR64+22+22インデックスの説明文を示すワイド文字配列。
dwIntervalDWORD4+88+88インデックスエントリ間の間隔。

各言語での定義

#include <windows.h>

// ASF_INDEX_IDENTIFIER  (x64 20 / x86 20 バイト)
typedef struct ASF_INDEX_IDENTIFIER {
    GUID guidIndexType;
    WORD wStreamNumber;
} ASF_INDEX_IDENTIFIER;

// ASF_INDEX_DESCRIPTOR  (x64 92 / x86 92 バイト)
typedef struct ASF_INDEX_DESCRIPTOR {
    ASF_INDEX_IDENTIFIER Identifier;
    WORD cPerEntryBytes;
    WCHAR szDescription[32];
    DWORD dwInterval;
} ASF_INDEX_DESCRIPTOR;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ASF_INDEX_IDENTIFIER
{
    public Guid guidIndexType;
    public ushort wStreamNumber;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct ASF_INDEX_DESCRIPTOR
{
    public ASF_INDEX_IDENTIFIER Identifier;
    public ushort cPerEntryBytes;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)] public string szDescription;
    public uint dwInterval;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ASF_INDEX_IDENTIFIER
    Public guidIndexType As Guid
    Public wStreamNumber As UShort
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure ASF_INDEX_DESCRIPTOR
    Public Identifier As ASF_INDEX_IDENTIFIER
    Public cPerEntryBytes As UShort
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=32)> Public szDescription As String
    Public dwInterval As UInteger
End Structure
import ctypes
from ctypes import wintypes

class ASF_INDEX_IDENTIFIER(ctypes.Structure):
    _fields_ = [
        ("guidIndexType", GUID),
        ("wStreamNumber", ctypes.c_ushort),
    ]

class ASF_INDEX_DESCRIPTOR(ctypes.Structure):
    _fields_ = [
        ("Identifier", ASF_INDEX_IDENTIFIER),
        ("cPerEntryBytes", ctypes.c_ushort),
        ("szDescription", ctypes.c_wchar * 32),
        ("dwInterval", wintypes.DWORD),
    ]
#[repr(C)]
pub struct ASF_INDEX_IDENTIFIER {
    pub guidIndexType: GUID,
    pub wStreamNumber: u16,
}

#[repr(C)]
pub struct ASF_INDEX_DESCRIPTOR {
    pub Identifier: ASF_INDEX_IDENTIFIER,
    pub cPerEntryBytes: u16,
    pub szDescription: [u16; 32],
    pub dwInterval: u32,
}
import "golang.org/x/sys/windows"

type ASF_INDEX_IDENTIFIER struct {
	guidIndexType windows.GUID
	wStreamNumber uint16
}

type ASF_INDEX_DESCRIPTOR struct {
	Identifier ASF_INDEX_IDENTIFIER
	cPerEntryBytes uint16
	szDescription [32]uint16
	dwInterval uint32
}
type
  ASF_INDEX_IDENTIFIER = record
    guidIndexType: TGUID;
    wStreamNumber: Word;
  end;

  ASF_INDEX_DESCRIPTOR = record
    Identifier: ASF_INDEX_IDENTIFIER;
    cPerEntryBytes: Word;
    szDescription: array[0..31] of WideChar;
    dwInterval: DWORD;
  end;
const ASF_INDEX_IDENTIFIER = extern struct {
    guidIndexType: GUID,
    wStreamNumber: u16,
};

const ASF_INDEX_DESCRIPTOR = extern struct {
    Identifier: ASF_INDEX_IDENTIFIER,
    cPerEntryBytes: u16,
    szDescription: [32]u16,
    dwInterval: u32,
};
type
  ASF_INDEX_IDENTIFIER {.bycopy.} = object
    guidIndexType: GUID
    wStreamNumber: uint16

  ASF_INDEX_DESCRIPTOR {.bycopy.} = object
    Identifier: ASF_INDEX_IDENTIFIER
    cPerEntryBytes: uint16
    szDescription: array[32, uint16]
    dwInterval: uint32
struct ASF_INDEX_IDENTIFIER
{
    GUID guidIndexType;
    ushort wStreamNumber;
}

struct ASF_INDEX_DESCRIPTOR
{
    ASF_INDEX_IDENTIFIER Identifier;
    ushort cPerEntryBytes;
    wchar[32] szDescription;
    uint dwInterval;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ASF_INDEX_DESCRIPTOR サイズ: 92 バイト(x64)
dim st, 23    ; 4byte整数×23(構造体サイズ 92 / 4 切り上げ)
; Identifier : ASF_INDEX_IDENTIFIER (+0, 20byte)  varptr(st)+0 を基点に操作(20byte:入れ子/配列)
; cPerEntryBytes : WORD (+20, 2byte)  wpoke st,20,値  /  値 = wpeek(st,20)
; szDescription : WCHAR (+22, 64byte)  varptr(st)+22 を基点に操作(64byte:入れ子/配列)
; dwInterval : DWORD (+88, 4byte)  st.22 = 値  /  値 = st.22   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
    #field int Data1
    #field short Data2
    #field short Data3
    #field byte Data4 8
#endstruct

#defstruct global ASF_INDEX_IDENTIFIER
    #field GUID guidIndexType
    #field short wStreamNumber
#endstruct

#defstruct global ASF_INDEX_DESCRIPTOR
    #field ASF_INDEX_IDENTIFIER Identifier
    #field short cPerEntryBytes
    #field wchar szDescription 32
    #field int dwInterval
#endstruct

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