AUDIO_VOLUME_NOTIFICATION_DATA
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| guidEventContext | GUID | 16 | +0 | +0 | IAudioEndpointVolumeCallback::OnNotify メソッドのコンテキスト値です。このメンバーは、エンドポイントのボリューム レベルまたはミュート状態を変更した IAudioEndpointVolume のメソッド呼び出しに入力パラメーターとして渡されたイベント コンテキスト GUID の値です。詳細については、「解説」を参照してください。 |
| bMuted | BOOL | 4 | +16 | +16 | オーディオ ストリームが現在ミュートされているかどうかを指定します。bMuted が TRUE の場合、ストリームはミュートされています。FALSE の場合、ストリームはミュートされていません。 |
| fMasterVolume | FLOAT | 4 | +20 | +20 | オーディオ ストリームの現在のマスター ボリューム レベルを指定します。ボリューム レベルは 0.0 から 1.0 の範囲に正規化され、0.0 が最小のボリューム レベル、1.0 が最大のレベルです。この範囲内では、正規化されたボリューム レベルと信号振幅の減衰との関係は、非線形のオーディオ テーパー曲線で表されます。オーディオ テーパーの詳細については、「Audio-Tapered Volume Controls」を参照してください。 |
| nChannels | DWORD | 4 | +24 | +24 | オーディオ ストリームのチャネル数を指定します。これは afChannelVolumes 配列の要素数でもあります。オーディオ ストリームに n 個のチャネルが含まれる場合、チャネルには 0 から n-1 までの番号が付けられます。特定のチャネルのボリューム レベルは、そのチャネル番号と一致するインデックスの配列要素に格納されます。 |
| afChannelVolumes | FLOAT | 4 | +28 | +28 | チャネル ボリュームの配列の最初の要素です。この要素には、オーディオ ストリームのチャネル 0 の現在のボリューム レベルが格納されます。オーディオ ストリームに複数のチャネルが含まれる場合、追加のチャネルのボリューム レベルは AUDIO_VOLUME_NOTIFICATION_DATA 構造体の直後に続きます。各チャネルのボリューム レベルは 0.0 から 1.0 の範囲に正規化され、0.0 が最小のボリューム レベル、1.0 が最大のレベルです。この範囲内では、正規化されたボリューム レベルと信号振幅の減衰との関係は、非線形のオーディオ テーパー曲線で表されます。 |
公式ドキュメント
AUDIO_VOLUME_NOTIFICATION_DATA 構造体は、オーディオ エンドポイント デバイスのボリューム レベルまたはミュート状態の変化を記述します。
解説(Remarks)
この構造体は IAudioEndpointVolumeCallback::OnNotify メソッドで使用されます。
クライアントは、エンドポイント デバイスのボリューム レベルまたはミュート状態が変化したときに通知を受け取るように登録できます。次のメソッドがこのような変化を引き起こす可能性があります。
- IAudioEndpointVolume::SetChannelVolumeLevel
- IAudioEndpointVolume::SetChannelVolumeLevelScalar
- IAudioEndpointVolume::SetMasterVolumeLevel
- IAudioEndpointVolume::SetMasterVolumeLevelScalar
- IAudioEndpointVolume::SetMute
- IAudioEndpointVolume::VolumeStepDown
- IAudioEndpointVolume::VolumeStepUp
上記の一覧の各メソッドは、イベント コンテキスト GUID へのポインターである pguidEventContext という名前の入力パラメーターを受け取ります。クライアントに通知を送信する前に、メソッドは pguidEventContext が指すイベント コンテキスト GUID を、クライアントの OnNotify メソッドを通じて提供する AUDIO_VOLUME_NOTIFICATION_DATA 構造体の guidEventContext メンバーにコピーします。pguidEventContext が NULL の場合、guidEventContext メンバーの値は GUID_NULL に設定されます。
クライアントは OnNotify メソッドの実装内で、その呼び出しのイベント コンテキスト GUID を調べることで、ボリューム変更イベントの発生元が自分自身か他のクライアントかを判別できます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// AUDIO_VOLUME_NOTIFICATION_DATA (x64 32 / x86 32 バイト)
typedef struct AUDIO_VOLUME_NOTIFICATION_DATA {
GUID guidEventContext;
BOOL bMuted;
FLOAT fMasterVolume;
DWORD nChannels;
FLOAT afChannelVolumes[1];
} AUDIO_VOLUME_NOTIFICATION_DATA;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct AUDIO_VOLUME_NOTIFICATION_DATA
{
public Guid guidEventContext;
[MarshalAs(UnmanagedType.Bool)] public bool bMuted;
public float fMasterVolume;
public uint nChannels;
[MarshalAs(UnmanagedType.ByValArray, SizeConst = 1)] public float[] afChannelVolumes;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure AUDIO_VOLUME_NOTIFICATION_DATA
Public guidEventContext As Guid
<MarshalAs(UnmanagedType.Bool)> Public bMuted As Boolean
Public fMasterVolume As Single
Public nChannels As UInteger
<MarshalAs(UnmanagedType.ByValArray, SizeConst:=1)> Public afChannelVolumes() As Single
End Structureimport ctypes
from ctypes import wintypes
class AUDIO_VOLUME_NOTIFICATION_DATA(ctypes.Structure):
_fields_ = [
("guidEventContext", GUID),
("bMuted", wintypes.BOOL),
("fMasterVolume", ctypes.c_float),
("nChannels", wintypes.DWORD),
("afChannelVolumes", ctypes.c_float * 1),
]#[repr(C)]
pub struct AUDIO_VOLUME_NOTIFICATION_DATA {
pub guidEventContext: GUID,
pub bMuted: i32,
pub fMasterVolume: f32,
pub nChannels: u32,
pub afChannelVolumes: [f32; 1],
}import "golang.org/x/sys/windows"
type AUDIO_VOLUME_NOTIFICATION_DATA struct {
guidEventContext windows.GUID
bMuted int32
fMasterVolume float32
nChannels uint32
afChannelVolumes [1]float32
}type
AUDIO_VOLUME_NOTIFICATION_DATA = record
guidEventContext: TGUID;
bMuted: BOOL;
fMasterVolume: Single;
nChannels: DWORD;
afChannelVolumes: array[0..0] of Single;
end;const AUDIO_VOLUME_NOTIFICATION_DATA = extern struct {
guidEventContext: GUID,
bMuted: i32,
fMasterVolume: f32,
nChannels: u32,
afChannelVolumes: [1]f32,
};type
AUDIO_VOLUME_NOTIFICATION_DATA {.bycopy.} = object
guidEventContext: GUID
bMuted: int32
fMasterVolume: float32
nChannels: uint32
afChannelVolumes: array[1, float32]struct AUDIO_VOLUME_NOTIFICATION_DATA
{
GUID guidEventContext;
int bMuted;
float fMasterVolume;
uint nChannels;
float[1] afChannelVolumes;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; AUDIO_VOLUME_NOTIFICATION_DATA サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; guidEventContext : GUID (+0, 16byte) varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; bMuted : BOOL (+16, 4byte) st.4 = 値 / 値 = st.4 (lpoke/lpeek も可)
; fMasterVolume : FLOAT (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; nChannels : DWORD (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; afChannelVolumes : FLOAT (+28, 4byte) varptr(st)+28 を基点に操作(4byte:入れ子/配列)
; ※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 AUDIO_VOLUME_NOTIFICATION_DATA
#field GUID guidEventContext
#field bool bMuted
#field float fMasterVolume
#field int nChannels
#field float afChannelVolumes 1
#endstruct
stdim st, AUDIO_VOLUME_NOTIFICATION_DATA ; NSTRUCT 変数を確保
st->bMuted = 100
mes "bMuted=" + st->bMuted