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

HEAACWAVEINFO

構造体
サイズx64: 30 バイト / x86: 30 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
wfxWAVEFORMATEX18+0+0SBR 拡張や PS 拡張を含まないコア AAC ストリームを記述する WAVEFORMATEX 構造体です。 「解説」を参照してください。
wPayloadTypeWORD2+18+18

ペイロードの種類です。

Value Meaning
0
ストリームには raw_data_block 要素のみが含まれます。
1
Audio Data Transport Stream (ADTS) です。ストリームには MPEG-2 で定義された adts_sequence が含まれます。
2
Audio Data Interchange Format (ADIF) です。ストリームには MPEG-2 で定義された adif_sequence が含まれます。
3
ストリームには、同期レイヤー (LOAS) と多重化レイヤー (LATM) を持つ MPEG-4 オーディオトランスポートストリームが含まれます。
wAudioProfileLevelIndicationWORD2+20+20ISO/IEC 14496-3 (MPEG-4 Audio) で定義されている audioProfileLevelIndication フィールドの値を格納します。値が不明な場合は、このメンバーに 0 または 0xFE ("no audio profile specified") を設定します。
wStructTypeWORD2+22+22

この構造体に続くデータを定義します。現在、次の値が定義されています。

Value Meaning
0
HEAACWAVEINFO 構造体に続くデータには、ISO/IEC 14496-3 で定義された AudioSpecificConfig() の値が含まれます。

データのサイズは wfx.cbSize - sizeof(HEAACWAVEINFO) + sizeof(WAVEFORMATEX) です。サイズが 0 より大きい場合は、HEAACWAVEINFO 構造体を HEAACWAVEFORMAT 構造体にキャストすることでデータにアクセスできます。

このメンバーのその他の値はすべて予約済みです。

wReserved1WORD2+24+24予約済みです。0 を設定します。
dwReserved2DWORD4+26+26予約済みです。0 を設定します。

公式ドキュメント

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

Advanced Audio Coding (AAC) または High-Efficiency Advanced Audio Coding (HE-AAC) ストリームのフォーマットデータを格納します。

解説(Remarks)

このフォーマット構造体は、HE-AAC バージョン 1 および HE-AAC バージョン 2 を含む、MPEG-2 AAC ストリームおよび MPEG-4 HE-AAC ストリームを記述するために使用します。

wfx メンバーで定義される WAVEFORMATEX 構造体には、次の値が格納されます。

Member Description
wFormatTag WAVE_FORMAT_MPEG_HEAAC (0x1610) でなければなりません。
nChannels コア AAC ストリームのチャネル数です。低周波 (LFE) チャネルが存在する場合はそれも含みます。 パラメトリックステレオ (PS) を使用している場合、この値はデコード後のストリームのチャネル数と異なることがあります。不明な場合は 0 を設定します。
nSamplesPerSec コア AAC ストリームのサンプリングレートです。この値は、MPEG-2 で定義されている 8000 Hz から 96000 Hz までのサポートされるサンプリングレートのいずれかでなければなりません。スペクトル帯域複製 (SBR) を使用している場合、この値はデコード後のストリームのサンプリングレートと異なることがあります。不明な場合は 0 を設定します。
nAvgBytesPerSec 圧縮ストリームの平均ビットレートから算出した、1 秒あたりの平均バイト数です。不明な場合は 0 を設定します。
nBlockAlign 1 を設定します。
wBitsPerSample デコード後の PCM オーディオストリームで希望する 1 サンプルあたりのビット数です。不明な場合は 0 を設定します。
cbSize WAVEFORMATEX 構造体に続くフォーマットデータのサイズをバイト単位で指定します。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// WAVEFORMATEX  (x64 18 / x86 18 バイト)
#pragma pack(push, 1)
typedef struct WAVEFORMATEX {
    WORD wFormatTag;
    WORD nChannels;
    DWORD nSamplesPerSec;
    DWORD nAvgBytesPerSec;
    WORD nBlockAlign;
    WORD wBitsPerSample;
    WORD cbSize;
} WAVEFORMATEX;
#pragma pack(pop)

// HEAACWAVEINFO  (x64 30 / x86 30 バイト)
#pragma pack(push, 1)
typedef struct HEAACWAVEINFO {
    WAVEFORMATEX wfx;
    WORD wPayloadType;
    WORD wAudioProfileLevelIndication;
    WORD wStructType;
    WORD wReserved1;
    DWORD dwReserved2;
} HEAACWAVEINFO;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct WAVEFORMATEX
{
    public ushort wFormatTag;
    public ushort nChannels;
    public uint nSamplesPerSec;
    public uint nAvgBytesPerSec;
    public ushort nBlockAlign;
    public ushort wBitsPerSample;
    public ushort cbSize;
}

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct HEAACWAVEINFO
{
    public WAVEFORMATEX wfx;
    public ushort wPayloadType;
    public ushort wAudioProfileLevelIndication;
    public ushort wStructType;
    public ushort wReserved1;
    public uint dwReserved2;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure WAVEFORMATEX
    Public wFormatTag As UShort
    Public nChannels As UShort
    Public nSamplesPerSec As UInteger
    Public nAvgBytesPerSec As UInteger
    Public nBlockAlign As UShort
    Public wBitsPerSample As UShort
    Public cbSize As UShort
End Structure

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure HEAACWAVEINFO
    Public wfx As WAVEFORMATEX
    Public wPayloadType As UShort
    Public wAudioProfileLevelIndication As UShort
    Public wStructType As UShort
    Public wReserved1 As UShort
    Public dwReserved2 As UInteger
End Structure
import ctypes
from ctypes import wintypes

class WAVEFORMATEX(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("wFormatTag", ctypes.c_ushort),
        ("nChannels", ctypes.c_ushort),
        ("nSamplesPerSec", wintypes.DWORD),
        ("nAvgBytesPerSec", wintypes.DWORD),
        ("nBlockAlign", ctypes.c_ushort),
        ("wBitsPerSample", ctypes.c_ushort),
        ("cbSize", ctypes.c_ushort),
    ]

class HEAACWAVEINFO(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("wfx", WAVEFORMATEX),
        ("wPayloadType", ctypes.c_ushort),
        ("wAudioProfileLevelIndication", ctypes.c_ushort),
        ("wStructType", ctypes.c_ushort),
        ("wReserved1", ctypes.c_ushort),
        ("dwReserved2", wintypes.DWORD),
    ]
#[repr(C, packed(1))]
pub struct WAVEFORMATEX {
    pub wFormatTag: u16,
    pub nChannels: u16,
    pub nSamplesPerSec: u32,
    pub nAvgBytesPerSec: u32,
    pub nBlockAlign: u16,
    pub wBitsPerSample: u16,
    pub cbSize: u16,
}

#[repr(C, packed(1))]
pub struct HEAACWAVEINFO {
    pub wfx: WAVEFORMATEX,
    pub wPayloadType: u16,
    pub wAudioProfileLevelIndication: u16,
    pub wStructType: u16,
    pub wReserved1: u16,
    pub dwReserved2: u32,
}
import "golang.org/x/sys/windows"

type WAVEFORMATEX struct {
	wFormatTag uint16
	nChannels uint16
	nSamplesPerSec uint32
	nAvgBytesPerSec uint32
	nBlockAlign uint16
	wBitsPerSample uint16
	cbSize uint16
}

type HEAACWAVEINFO struct {
	wfx WAVEFORMATEX
	wPayloadType uint16
	wAudioProfileLevelIndication uint16
	wStructType uint16
	wReserved1 uint16
	dwReserved2 uint32
}
type
  WAVEFORMATEX = packed record
    wFormatTag: Word;
    nChannels: Word;
    nSamplesPerSec: DWORD;
    nAvgBytesPerSec: DWORD;
    nBlockAlign: Word;
    wBitsPerSample: Word;
    cbSize: Word;
  end;

  HEAACWAVEINFO = packed record
    wfx: WAVEFORMATEX;
    wPayloadType: Word;
    wAudioProfileLevelIndication: Word;
    wStructType: Word;
    wReserved1: Word;
    dwReserved2: DWORD;
  end;
const WAVEFORMATEX = extern struct {
    wFormatTag: u16,
    nChannels: u16,
    nSamplesPerSec: u32,
    nAvgBytesPerSec: u32,
    nBlockAlign: u16,
    wBitsPerSample: u16,
    cbSize: u16,
};

const HEAACWAVEINFO = extern struct {
    wfx: WAVEFORMATEX,
    wPayloadType: u16,
    wAudioProfileLevelIndication: u16,
    wStructType: u16,
    wReserved1: u16,
    dwReserved2: u32,
};
type
  WAVEFORMATEX {.packed.} = object
    wFormatTag: uint16
    nChannels: uint16
    nSamplesPerSec: uint32
    nAvgBytesPerSec: uint32
    nBlockAlign: uint16
    wBitsPerSample: uint16
    cbSize: uint16

  HEAACWAVEINFO {.packed.} = object
    wfx: WAVEFORMATEX
    wPayloadType: uint16
    wAudioProfileLevelIndication: uint16
    wStructType: uint16
    wReserved1: uint16
    dwReserved2: uint32
align(1)
struct WAVEFORMATEX
{
    ushort wFormatTag;
    ushort nChannels;
    uint nSamplesPerSec;
    uint nAvgBytesPerSec;
    ushort nBlockAlign;
    ushort wBitsPerSample;
    ushort cbSize;
}

align(1)
struct HEAACWAVEINFO
{
    WAVEFORMATEX wfx;
    ushort wPayloadType;
    ushort wAudioProfileLevelIndication;
    ushort wStructType;
    ushort wReserved1;
    uint dwReserved2;
}

HSP用 定義

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

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

#defstruct global HEAACWAVEINFO, pack=1
    #field WAVEFORMATEX wfx
    #field short wPayloadType
    #field short wAudioProfileLevelIndication
    #field short wStructType
    #field short wReserved1
    #field int dwReserved2
#endstruct

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