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当該メトリクスが計測された時刻のタイムスタンプ(100ナノ秒単位)を示す。
ConvergenceFlagBYTE1+8+8エコー除去フィルタが収束済みか否かを示すフラグである。
MicClippedFlagBYTE1+9+9マイク入力信号がクリッピングしたか否かを示すフラグである。
MicSilenceFlagBYTE1+10+10マイク入力が無音状態か否かを示すフラグである。
PstvFeadbackFlagBYTE1+11+11正のフィードバック(ハウリング傾向)を検出したか否かを示すフラグである。
SpkClippedFlagBYTE1+12+12スピーカー出力信号がクリッピングしたか否かを示すフラグである。
SpkMuteFlagBYTE1+13+13スピーカー出力がミュート状態か否かを示すフラグである。
GlitchFlagBYTE1+14+14音声グリッチ(途切れ)が発生したか否かを示すフラグである。
DoubleTalkFlagBYTE1+15+15近端と遠端が同時発話するダブルトーク状態か否かを示すフラグである。
uGlitchCountDWORD4+16+16計測区間中に発生した音声グリッチの累積回数を示す。
uMicClipCountDWORD4+20+20計測区間中にマイク信号がクリップした累積回数を示す。
fDurationFLOAT4+24+24当該メトリクスが対象とする計測区間の長さ(秒)を示す。
fTSVarianceFLOAT4+28+28タイムスタンプの分散を示す。クロック安定性の指標となる。
fTSDriftRateFLOAT4+32+32サンプリングクロックのドリフト率を示す。
fVoiceLevelFLOAT4+36+36推定された音声(近端)信号のレベルを示す。
fNoiseLevelFLOAT4+40+40推定された背景雑音のレベルを示す。
fERLEFLOAT4+44+44エコー戻り損失強調(ERLE)の瞬時値をdBで示す。エコー除去性能の指標。
fAvgERLEFLOAT4+48+48ERLEの平均値をdBで示す。
dwReservedDWORD4+52+52将来拡張のための予約フィールドである。0を設定する。

各言語での定義

#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