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

AecQualityMetrics_Struct

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

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

フィールド

フィールド型サイズx64x86説明
i64TimestampLONGLONG8+0+0品質メトリックが収集された時点を示すタイム スタンプです。
ConvergenceFlagBYTE1+8+8AEC の収束フラグです。
MicClippedFlagBYTE1+9+9TRUE の場合、オーディオ キャプチャ デバイスからの入力信号がクリップされたことを示します。
MicSilenceFlagBYTE1+10+10TRUE の場合、オーディオ キャプチャ デバイスからの入力信号が無音であるか、音量が小さすぎたことを示します。
PstvFeadbackFlagBYTE1+11+11TRUE の場合、正のフィードバックによってチャープ音が発生していることを示します。
SpkClippedFlagBYTE1+12+12TRUE の場合、オーディオ レンダリング デバイスからの入力信号がクリップされたことを示します。
SpkMuteFlagBYTE1+13+13TRUE の場合、オーディオ レンダリング デバイスからの入力信号が無音であるか、音量が小さすぎたことを示します。
GlitchFlagBYTE1+14+14入力データでグリッチが発生したことを示します。
DoubleTalkFlagBYTE1+15+15ダブル トークのフラグです。
uGlitchCountDWORD4+16+16グリッチの発生回数です。
uMicClipCountDWORD4+20+20オーディオ キャプチャ信号がクリップされた回数です。
fDurationFLOAT4+24+24AEC 処理の実行継続時間です。
fTSVarianceFLOAT4+28+28タイム スタンプの長期平均分散です。
fTSDriftRateFLOAT4+32+32タイム スタンプの長期平均ドリフト率です。
fVoiceLevelFLOAT4+36+36AEC 処理後の近端側の音声レベルです。
fNoiseLevelFLOAT4+40+40オーディオ キャプチャ信号のノイズ レベルです。
fERLEFLOAT4+44+44エコー リターン ロス エンハンスメント (ERLE) です。
fAvgERLEFLOAT4+48+48AEC 処理の全期間にわたる平均 ERLE です。
dwReservedDWORD4+52+52予約済みです。

公式ドキュメント

音響エコー キャンセル (AEC) の品質メトリックを格納します。この構造体は MFPKEY_WMAAECMA_RETRIEVE_TS_STATS プロパティと共に使用されます。

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

各言語での定義

#include <windows.h>

// AecQualityMetrics_Struct  (x64 56 / x86 56 バイト)
typedef struct AecQualityMetrics_Struct {
    LONGLONG i64Timestamp;
    BYTE ConvergenceFlag;
    BYTE MicClippedFlag;
    BYTE MicSilenceFlag;
    BYTE PstvFeadbackFlag;
    BYTE SpkClippedFlag;
    BYTE SpkMuteFlag;
    BYTE GlitchFlag;
    BYTE DoubleTalkFlag;
    DWORD uGlitchCount;
    DWORD uMicClipCount;
    FLOAT fDuration;
    FLOAT fTSVariance;
    FLOAT fTSDriftRate;
    FLOAT fVoiceLevel;
    FLOAT fNoiseLevel;
    FLOAT fERLE;
    FLOAT fAvgERLE;
    DWORD dwReserved;
} AecQualityMetrics_Struct;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct AecQualityMetrics_Struct
{
    public long i64Timestamp;
    public byte ConvergenceFlag;
    public byte MicClippedFlag;
    public byte MicSilenceFlag;
    public byte PstvFeadbackFlag;
    public byte SpkClippedFlag;
    public byte SpkMuteFlag;
    public byte GlitchFlag;
    public byte DoubleTalkFlag;
    public uint uGlitchCount;
    public uint uMicClipCount;
    public float fDuration;
    public float fTSVariance;
    public float fTSDriftRate;
    public float fVoiceLevel;
    public float fNoiseLevel;
    public float fERLE;
    public float fAvgERLE;
    public uint dwReserved;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure AecQualityMetrics_Struct
    Public i64Timestamp As Long
    Public ConvergenceFlag As Byte
    Public MicClippedFlag As Byte
    Public MicSilenceFlag As Byte
    Public PstvFeadbackFlag As Byte
    Public SpkClippedFlag As Byte
    Public SpkMuteFlag As Byte
    Public GlitchFlag As Byte
    Public DoubleTalkFlag As Byte
    Public uGlitchCount As UInteger
    Public uMicClipCount As UInteger
    Public fDuration As Single
    Public fTSVariance As Single
    Public fTSDriftRate As Single
    Public fVoiceLevel As Single
    Public fNoiseLevel As Single
    Public fERLE As Single
    Public fAvgERLE As Single
    Public dwReserved As UInteger
End Structure
import ctypes
from ctypes import wintypes

class AecQualityMetrics_Struct(ctypes.Structure):
    _fields_ = [
        ("i64Timestamp", ctypes.c_longlong),
        ("ConvergenceFlag", ctypes.c_ubyte),
        ("MicClippedFlag", ctypes.c_ubyte),
        ("MicSilenceFlag", ctypes.c_ubyte),
        ("PstvFeadbackFlag", ctypes.c_ubyte),
        ("SpkClippedFlag", ctypes.c_ubyte),
        ("SpkMuteFlag", ctypes.c_ubyte),
        ("GlitchFlag", ctypes.c_ubyte),
        ("DoubleTalkFlag", ctypes.c_ubyte),
        ("uGlitchCount", wintypes.DWORD),
        ("uMicClipCount", wintypes.DWORD),
        ("fDuration", ctypes.c_float),
        ("fTSVariance", ctypes.c_float),
        ("fTSDriftRate", ctypes.c_float),
        ("fVoiceLevel", ctypes.c_float),
        ("fNoiseLevel", ctypes.c_float),
        ("fERLE", ctypes.c_float),
        ("fAvgERLE", ctypes.c_float),
        ("dwReserved", wintypes.DWORD),
    ]
#[repr(C)]
pub struct AecQualityMetrics_Struct {
    pub i64Timestamp: i64,
    pub ConvergenceFlag: u8,
    pub MicClippedFlag: u8,
    pub MicSilenceFlag: u8,
    pub PstvFeadbackFlag: u8,
    pub SpkClippedFlag: u8,
    pub SpkMuteFlag: u8,
    pub GlitchFlag: u8,
    pub DoubleTalkFlag: u8,
    pub uGlitchCount: u32,
    pub uMicClipCount: u32,
    pub fDuration: f32,
    pub fTSVariance: f32,
    pub fTSDriftRate: f32,
    pub fVoiceLevel: f32,
    pub fNoiseLevel: f32,
    pub fERLE: f32,
    pub fAvgERLE: f32,
    pub dwReserved: u32,
}
import "golang.org/x/sys/windows"

type AecQualityMetrics_Struct struct {
	i64Timestamp int64
	ConvergenceFlag byte
	MicClippedFlag byte
	MicSilenceFlag byte
	PstvFeadbackFlag byte
	SpkClippedFlag byte
	SpkMuteFlag byte
	GlitchFlag byte
	DoubleTalkFlag byte
	uGlitchCount uint32
	uMicClipCount uint32
	fDuration float32
	fTSVariance float32
	fTSDriftRate float32
	fVoiceLevel float32
	fNoiseLevel float32
	fERLE float32
	fAvgERLE float32
	dwReserved uint32
}
type
  AecQualityMetrics_Struct = record
    i64Timestamp: Int64;
    ConvergenceFlag: Byte;
    MicClippedFlag: Byte;
    MicSilenceFlag: Byte;
    PstvFeadbackFlag: Byte;
    SpkClippedFlag: Byte;
    SpkMuteFlag: Byte;
    GlitchFlag: Byte;
    DoubleTalkFlag: Byte;
    uGlitchCount: DWORD;
    uMicClipCount: DWORD;
    fDuration: Single;
    fTSVariance: Single;
    fTSDriftRate: Single;
    fVoiceLevel: Single;
    fNoiseLevel: Single;
    fERLE: Single;
    fAvgERLE: Single;
    dwReserved: DWORD;
  end;
const AecQualityMetrics_Struct = extern struct {
    i64Timestamp: i64,
    ConvergenceFlag: u8,
    MicClippedFlag: u8,
    MicSilenceFlag: u8,
    PstvFeadbackFlag: u8,
    SpkClippedFlag: u8,
    SpkMuteFlag: u8,
    GlitchFlag: u8,
    DoubleTalkFlag: u8,
    uGlitchCount: u32,
    uMicClipCount: u32,
    fDuration: f32,
    fTSVariance: f32,
    fTSDriftRate: f32,
    fVoiceLevel: f32,
    fNoiseLevel: f32,
    fERLE: f32,
    fAvgERLE: f32,
    dwReserved: u32,
};
type
  AecQualityMetrics_Struct {.bycopy.} = object
    i64Timestamp: int64
    ConvergenceFlag: uint8
    MicClippedFlag: uint8
    MicSilenceFlag: uint8
    PstvFeadbackFlag: uint8
    SpkClippedFlag: uint8
    SpkMuteFlag: uint8
    GlitchFlag: uint8
    DoubleTalkFlag: uint8
    uGlitchCount: uint32
    uMicClipCount: uint32
    fDuration: float32
    fTSVariance: float32
    fTSDriftRate: float32
    fVoiceLevel: float32
    fNoiseLevel: float32
    fERLE: float32
    fAvgERLE: float32
    dwReserved: uint32
struct AecQualityMetrics_Struct
{
    long i64Timestamp;
    ubyte ConvergenceFlag;
    ubyte MicClippedFlag;
    ubyte MicSilenceFlag;
    ubyte PstvFeadbackFlag;
    ubyte SpkClippedFlag;
    ubyte SpkMuteFlag;
    ubyte GlitchFlag;
    ubyte DoubleTalkFlag;
    uint uGlitchCount;
    uint uMicClipCount;
    float fDuration;
    float fTSVariance;
    float fTSDriftRate;
    float fVoiceLevel;
    float fNoiseLevel;
    float fERLE;
    float fAvgERLE;
    uint dwReserved;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AecQualityMetrics_Struct サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; i64Timestamp : LONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; ConvergenceFlag : BYTE (+8, 1byte)  poke st,8,値  /  値 = peek(st,8)
; MicClippedFlag : BYTE (+9, 1byte)  poke st,9,値  /  値 = peek(st,9)
; MicSilenceFlag : BYTE (+10, 1byte)  poke st,10,値  /  値 = peek(st,10)
; PstvFeadbackFlag : BYTE (+11, 1byte)  poke st,11,値  /  値 = peek(st,11)
; SpkClippedFlag : BYTE (+12, 1byte)  poke st,12,値  /  値 = peek(st,12)
; SpkMuteFlag : BYTE (+13, 1byte)  poke st,13,値  /  値 = peek(st,13)
; GlitchFlag : BYTE (+14, 1byte)  poke st,14,値  /  値 = peek(st,14)
; DoubleTalkFlag : BYTE (+15, 1byte)  poke st,15,値  /  値 = peek(st,15)
; uGlitchCount : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; uMicClipCount : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; fDuration : FLOAT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; fTSVariance : FLOAT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; fTSDriftRate : FLOAT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; fVoiceLevel : FLOAT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; fNoiseLevel : FLOAT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; fERLE : FLOAT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; fAvgERLE : FLOAT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; dwReserved : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global AecQualityMetrics_Struct
    #field int64 i64Timestamp
    #field byte ConvergenceFlag
    #field byte MicClippedFlag
    #field byte MicSilenceFlag
    #field byte PstvFeadbackFlag
    #field byte SpkClippedFlag
    #field byte SpkMuteFlag
    #field byte GlitchFlag
    #field byte DoubleTalkFlag
    #field int uGlitchCount
    #field int uMicClipCount
    #field float fDuration
    #field float fTSVariance
    #field float fTSDriftRate
    #field float fVoiceLevel
    #field float fNoiseLevel
    #field float fERLE
    #field float fAvgERLE
    #field int dwReserved
#endstruct

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