ホーム › Media.Audio.XAudio2 › XAUDIO2_PERFORMANCE_DATA

XAUDIO2_PERFORMANCE_DATA

構造体

📘 Microsoft Learn (日本語) · English

サイズx64: 64 バイト / x86: 64 バイトパッキング1

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

フィールド

型

サイズ

x64

x86

説明

AudioCyclesSinceLastQuery

ULONGLONG

IXAudio2::StartEngine または IXAudio2::GetPerformanceData 関数を最後に呼び出して以降、オーディオ処理に費やされた CPU サイクル数。

TotalCyclesSinceLastQuery

ULONGLONG

最後の呼び出し以降に経過した CPU サイクルの総数。

メモこれは XAudio2 が実行されている CPU のサイクルのみをカウントします。

MinimumCyclesPerQuantum

DWORD

+16

最後の呼び出し以降、いずれかの単一オーディオクォンタムの処理に費やされた最小の CPU サイクル数。

MaximumCyclesPerQuantum

DWORD

+20

最後の呼び出し以降、いずれかの単一オーディオクォンタムの処理に費やされた最大の CPU サイクル数。

MemoryUsageInBytes

DWORD

+24

現在使用中のメモリの総量。

CurrentLatencyInSamples

DWORD

+28

サンプルがソースバッファーから読み取られてからスピーカーに到達するまでに発生する最小の遅延。

Windows

報告される遅延は、XAudio2 がドライバーに最後に送信したサンプルと現在再生中のサンプルとのおおよその隔たりに等しい可変値です。この遅延には次の要因が影響する可能性があります。ハードウェアアクセラレーションが有効なデバイスでのマルチチャネルオーディオの再生、オーディオデバイスの種類 (WavePci、WaveCyclic、または WaveRT)、および程度は小さいもののオーディオハードウェアの実装。

Xbox 360
報告される遅延は固定値で、通常は 1,024 サンプル (48 kHz で 21.333 ms) です。XOverrideSpeakerConfig が XAUDIOSPEAKERCONFIG_LOW_LATENCY フラグを使用して呼び出されている場合、報告される遅延は 512 サンプル (48 kHz で 10.667 ms) になります。

GlitchesSinceEngineStarted

DWORD

+32

エンジンの開始以降に発生したオーディオドロップアウトの総数。

ActiveSourceVoiceCount

DWORD

+36

現在再生中のソースボイスの数。

TotalSourceVoiceCount

DWORD

+40

現在存在するソースボイスの総数。

ActiveSubmixVoiceCount

DWORD

+44

現在再生中のサブミックスボイスの数。

ActiveResamplerCount

DWORD

+48

現在アクティブなリサンプラー xAPO の数。

ActiveMatrixMixCount

DWORD

+52

現在アクティブなマトリックスミックス xAPO の数。

ActiveXmaSourceVoices

DWORD

+56

Windows
サポートされていません。

Xbox 360
XMA データをデコードしているソースボイスの数。

ActiveXmaStreams

DWORD

+60

Windows
サポートされていません。

Xbox 360
1 つのボイスは複数の XMA ストリームを使用できます。

公式ドキュメント

パフォーマンス情報を格納します。

解説(Remarks)

CPU サイクルはを使用して記録されます。これらの値を変換するにはを使用します。

プラットフォーム要件

Windows 10 (XAudio2.9)、Windows 8、Windows Phone 8 (XAudio 2.8)、DirectX SDK (XAudio 2.7)

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

各言語での定義

#include <windows.h>

// XAUDIO2_PERFORMANCE_DATA  (x64 64 / x86 64 バイト)
#pragma pack(push, 1)
typedef struct XAUDIO2_PERFORMANCE_DATA {
    ULONGLONG AudioCyclesSinceLastQuery;
    ULONGLONG TotalCyclesSinceLastQuery;
    DWORD MinimumCyclesPerQuantum;
    DWORD MaximumCyclesPerQuantum;
    DWORD MemoryUsageInBytes;
    DWORD CurrentLatencyInSamples;
    DWORD GlitchesSinceEngineStarted;
    DWORD ActiveSourceVoiceCount;
    DWORD TotalSourceVoiceCount;
    DWORD ActiveSubmixVoiceCount;
    DWORD ActiveResamplerCount;
    DWORD ActiveMatrixMixCount;
    DWORD ActiveXmaSourceVoices;
    DWORD ActiveXmaStreams;
} XAUDIO2_PERFORMANCE_DATA;
#pragma pack(pop)

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct XAUDIO2_PERFORMANCE_DATA
{
    public ulong AudioCyclesSinceLastQuery;
    public ulong TotalCyclesSinceLastQuery;
    public uint MinimumCyclesPerQuantum;
    public uint MaximumCyclesPerQuantum;
    public uint MemoryUsageInBytes;
    public uint CurrentLatencyInSamples;
    public uint GlitchesSinceEngineStarted;
    public uint ActiveSourceVoiceCount;
    public uint TotalSourceVoiceCount;
    public uint ActiveSubmixVoiceCount;
    public uint ActiveResamplerCount;
    public uint ActiveMatrixMixCount;
    public uint ActiveXmaSourceVoices;
    public uint ActiveXmaStreams;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure XAUDIO2_PERFORMANCE_DATA
    Public AudioCyclesSinceLastQuery As ULong
    Public TotalCyclesSinceLastQuery As ULong
    Public MinimumCyclesPerQuantum As UInteger
    Public MaximumCyclesPerQuantum As UInteger
    Public MemoryUsageInBytes As UInteger
    Public CurrentLatencyInSamples As UInteger
    Public GlitchesSinceEngineStarted As UInteger
    Public ActiveSourceVoiceCount As UInteger
    Public TotalSourceVoiceCount As UInteger
    Public ActiveSubmixVoiceCount As UInteger
    Public ActiveResamplerCount As UInteger
    Public ActiveMatrixMixCount As UInteger
    Public ActiveXmaSourceVoices As UInteger
    Public ActiveXmaStreams As UInteger
End Structure

import ctypes
from ctypes import wintypes

class XAUDIO2_PERFORMANCE_DATA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("AudioCyclesSinceLastQuery", ctypes.c_ulonglong),
        ("TotalCyclesSinceLastQuery", ctypes.c_ulonglong),
        ("MinimumCyclesPerQuantum", wintypes.DWORD),
        ("MaximumCyclesPerQuantum", wintypes.DWORD),
        ("MemoryUsageInBytes", wintypes.DWORD),
        ("CurrentLatencyInSamples", wintypes.DWORD),
        ("GlitchesSinceEngineStarted", wintypes.DWORD),
        ("ActiveSourceVoiceCount", wintypes.DWORD),
        ("TotalSourceVoiceCount", wintypes.DWORD),
        ("ActiveSubmixVoiceCount", wintypes.DWORD),
        ("ActiveResamplerCount", wintypes.DWORD),
        ("ActiveMatrixMixCount", wintypes.DWORD),
        ("ActiveXmaSourceVoices", wintypes.DWORD),
        ("ActiveXmaStreams", wintypes.DWORD),
    ]

#[repr(C, packed(1))]
pub struct XAUDIO2_PERFORMANCE_DATA {
    pub AudioCyclesSinceLastQuery: u64,
    pub TotalCyclesSinceLastQuery: u64,
    pub MinimumCyclesPerQuantum: u32,
    pub MaximumCyclesPerQuantum: u32,
    pub MemoryUsageInBytes: u32,
    pub CurrentLatencyInSamples: u32,
    pub GlitchesSinceEngineStarted: u32,
    pub ActiveSourceVoiceCount: u32,
    pub TotalSourceVoiceCount: u32,
    pub ActiveSubmixVoiceCount: u32,
    pub ActiveResamplerCount: u32,
    pub ActiveMatrixMixCount: u32,
    pub ActiveXmaSourceVoices: u32,
    pub ActiveXmaStreams: u32,
}

import "golang.org/x/sys/windows"

type XAUDIO2_PERFORMANCE_DATA struct {
	AudioCyclesSinceLastQuery uint64
	TotalCyclesSinceLastQuery uint64
	MinimumCyclesPerQuantum uint32
	MaximumCyclesPerQuantum uint32
	MemoryUsageInBytes uint32
	CurrentLatencyInSamples uint32
	GlitchesSinceEngineStarted uint32
	ActiveSourceVoiceCount uint32
	TotalSourceVoiceCount uint32
	ActiveSubmixVoiceCount uint32
	ActiveResamplerCount uint32
	ActiveMatrixMixCount uint32
	ActiveXmaSourceVoices uint32
	ActiveXmaStreams uint32
}

type
  XAUDIO2_PERFORMANCE_DATA = packed record
    AudioCyclesSinceLastQuery: UInt64;
    TotalCyclesSinceLastQuery: UInt64;
    MinimumCyclesPerQuantum: DWORD;
    MaximumCyclesPerQuantum: DWORD;
    MemoryUsageInBytes: DWORD;
    CurrentLatencyInSamples: DWORD;
    GlitchesSinceEngineStarted: DWORD;
    ActiveSourceVoiceCount: DWORD;
    TotalSourceVoiceCount: DWORD;
    ActiveSubmixVoiceCount: DWORD;
    ActiveResamplerCount: DWORD;
    ActiveMatrixMixCount: DWORD;
    ActiveXmaSourceVoices: DWORD;
    ActiveXmaStreams: DWORD;
  end;

const XAUDIO2_PERFORMANCE_DATA = extern struct {
    AudioCyclesSinceLastQuery: u64,
    TotalCyclesSinceLastQuery: u64,
    MinimumCyclesPerQuantum: u32,
    MaximumCyclesPerQuantum: u32,
    MemoryUsageInBytes: u32,
    CurrentLatencyInSamples: u32,
    GlitchesSinceEngineStarted: u32,
    ActiveSourceVoiceCount: u32,
    TotalSourceVoiceCount: u32,
    ActiveSubmixVoiceCount: u32,
    ActiveResamplerCount: u32,
    ActiveMatrixMixCount: u32,
    ActiveXmaSourceVoices: u32,
    ActiveXmaStreams: u32,
};

type
  XAUDIO2_PERFORMANCE_DATA {.packed.} = object
    AudioCyclesSinceLastQuery: uint64
    TotalCyclesSinceLastQuery: uint64
    MinimumCyclesPerQuantum: uint32
    MaximumCyclesPerQuantum: uint32
    MemoryUsageInBytes: uint32
    CurrentLatencyInSamples: uint32
    GlitchesSinceEngineStarted: uint32
    ActiveSourceVoiceCount: uint32
    TotalSourceVoiceCount: uint32
    ActiveSubmixVoiceCount: uint32
    ActiveResamplerCount: uint32
    ActiveMatrixMixCount: uint32
    ActiveXmaSourceVoices: uint32
    ActiveXmaStreams: uint32

align(1)
struct XAUDIO2_PERFORMANCE_DATA
{
    ulong AudioCyclesSinceLastQuery;
    ulong TotalCyclesSinceLastQuery;
    uint MinimumCyclesPerQuantum;
    uint MaximumCyclesPerQuantum;
    uint MemoryUsageInBytes;
    uint CurrentLatencyInSamples;
    uint GlitchesSinceEngineStarted;
    uint ActiveSourceVoiceCount;
    uint TotalSourceVoiceCount;
    uint ActiveSubmixVoiceCount;
    uint ActiveResamplerCount;
    uint ActiveMatrixMixCount;
    uint ActiveXmaSourceVoices;
    uint ActiveXmaStreams;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; XAUDIO2_PERFORMANCE_DATA サイズ: 64 バイト(x64)
dim st, 16    ; 4byte整数×16(構造体サイズ 64 / 4 切り上げ)
; AudioCyclesSinceLastQuery : ULONGLONG (+0, 8byte)  qpoke st,0,値 / qpeek(st,0)  ※IronHSPのみ。3.7/3.8は lpoke st,0,下位 : lpoke st,4,上位
; TotalCyclesSinceLastQuery : ULONGLONG (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; MinimumCyclesPerQuantum : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; MaximumCyclesPerQuantum : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; MemoryUsageInBytes : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; CurrentLatencyInSamples : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; GlitchesSinceEngineStarted : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ActiveSourceVoiceCount : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; TotalSourceVoiceCount : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; ActiveSubmixVoiceCount : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; ActiveResamplerCount : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; ActiveMatrixMixCount : DWORD (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; ActiveXmaSourceVoices : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ActiveXmaStreams : DWORD (+60, 4byte)  st.15 = 値  /  値 = st.15   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。

; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global XAUDIO2_PERFORMANCE_DATA, pack=1
    #field int64 AudioCyclesSinceLastQuery
    #field int64 TotalCyclesSinceLastQuery
    #field int MinimumCyclesPerQuantum
    #field int MaximumCyclesPerQuantum
    #field int MemoryUsageInBytes
    #field int CurrentLatencyInSamples
    #field int GlitchesSinceEngineStarted
    #field int ActiveSourceVoiceCount
    #field int TotalSourceVoiceCount
    #field int ActiveSubmixVoiceCount
    #field int ActiveResamplerCount
    #field int ActiveMatrixMixCount
    #field int ActiveXmaSourceVoices
    #field int ActiveXmaStreams
#endstruct

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

XAUDIO2_PERFORMANCE_DATA

フィールド

公式ドキュメント

解説(Remarks)

プラットフォーム要件

各言語での定義

HSP用 定義

HSP用定義