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

AUDIO_VOLUME_NOTIFICATION_DATA

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

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

フィールド

フィールド型サイズx64x86説明
guidEventContextGUID16+0+0音量変更を発生させたイベントのコンテキストGUID。発信元識別用。
bMutedBOOL4+16+16ミュート状態か否か(BOOL、TRUEでミュート)。
fMasterVolumeFLOAT4+20+20マスター音量レベル(0.0〜1.0の正規化値)。
nChannelsDWORD4+24+24afChannelVolumes配列に含まれるチャンネル数。
afChannelVolumesFLOAT4+28+28各チャンネルの音量レベル配列(0.0〜1.0、可変長)。

各言語での定義

#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 Structure
import 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