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

KSDS3D_BUFFER_ALL

構造体
サイズx64: 60 バイト / x86: 60 バイト

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

フィールド

フィールド型サイズx64x86説明
PositionDS3DVECTOR12+0+03D空間における音源(バッファ)の位置ベクトルを表す。
VelocityDS3DVECTOR12+12+12音源の速度ベクトルを表し、ドップラー効果に使用する。
InsideConeAngleDWORD4+24+24音量が減衰しない内側コーンの角度を度単位で表す。
OutsideConeAngleDWORD4+28+28外側コーンの角度を度単位で表す。
ConeOrientationDS3DVECTOR12+32+32サウンドコーンが向く方向を示すベクトルである。
ConeOutsideVolumeINT4+44+44外側コーン外での音量減衰量を100分の1dB単位で表す。
MinDistanceFLOAT4+48+48これ以上近づいても音量が増えない最小距離を表す。
MaxDistanceFLOAT4+52+52これ以上離れても音量が減らない最大距離を表す。
ModeDWORD4+56+563D処理モード(通常・ヘッド相対・無効)を示すフラグである。

各言語での定義

#include <windows.h>

// DS3DVECTOR  (x64 12 / x86 12 バイト)
typedef struct DS3DVECTOR {
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
} DS3DVECTOR;

// KSDS3D_BUFFER_ALL  (x64 60 / x86 60 バイト)
typedef struct KSDS3D_BUFFER_ALL {
    DS3DVECTOR Position;
    DS3DVECTOR Velocity;
    DWORD InsideConeAngle;
    DWORD OutsideConeAngle;
    DS3DVECTOR ConeOrientation;
    INT ConeOutsideVolume;
    FLOAT MinDistance;
    FLOAT MaxDistance;
    DWORD Mode;
} KSDS3D_BUFFER_ALL;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DS3DVECTOR
{
    public _Anonymous1_e__Union Anonymous1;
    public _Anonymous2_e__Union Anonymous2;
    public _Anonymous3_e__Union Anonymous3;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct KSDS3D_BUFFER_ALL
{
    public DS3DVECTOR Position;
    public DS3DVECTOR Velocity;
    public uint InsideConeAngle;
    public uint OutsideConeAngle;
    public DS3DVECTOR ConeOrientation;
    public int ConeOutsideVolume;
    public float MinDistance;
    public float MaxDistance;
    public uint Mode;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DS3DVECTOR
    Public Anonymous1 As _Anonymous1_e__Union
    Public Anonymous2 As _Anonymous2_e__Union
    Public Anonymous3 As _Anonymous3_e__Union
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure KSDS3D_BUFFER_ALL
    Public Position As DS3DVECTOR
    Public Velocity As DS3DVECTOR
    Public InsideConeAngle As UInteger
    Public OutsideConeAngle As UInteger
    Public ConeOrientation As DS3DVECTOR
    Public ConeOutsideVolume As Integer
    Public MinDistance As Single
    Public MaxDistance As Single
    Public Mode As UInteger
End Structure
import ctypes
from ctypes import wintypes

class DS3DVECTOR(ctypes.Structure):
    _fields_ = [
        ("Anonymous1", _Anonymous1_e__Union),
        ("Anonymous2", _Anonymous2_e__Union),
        ("Anonymous3", _Anonymous3_e__Union),
    ]

class KSDS3D_BUFFER_ALL(ctypes.Structure):
    _fields_ = [
        ("Position", DS3DVECTOR),
        ("Velocity", DS3DVECTOR),
        ("InsideConeAngle", wintypes.DWORD),
        ("OutsideConeAngle", wintypes.DWORD),
        ("ConeOrientation", DS3DVECTOR),
        ("ConeOutsideVolume", ctypes.c_int),
        ("MinDistance", ctypes.c_float),
        ("MaxDistance", ctypes.c_float),
        ("Mode", wintypes.DWORD),
    ]
#[repr(C)]
pub struct DS3DVECTOR {
    pub Anonymous1: _Anonymous1_e__Union,
    pub Anonymous2: _Anonymous2_e__Union,
    pub Anonymous3: _Anonymous3_e__Union,
}

#[repr(C)]
pub struct KSDS3D_BUFFER_ALL {
    pub Position: DS3DVECTOR,
    pub Velocity: DS3DVECTOR,
    pub InsideConeAngle: u32,
    pub OutsideConeAngle: u32,
    pub ConeOrientation: DS3DVECTOR,
    pub ConeOutsideVolume: i32,
    pub MinDistance: f32,
    pub MaxDistance: f32,
    pub Mode: u32,
}
import "golang.org/x/sys/windows"

type DS3DVECTOR struct {
	Anonymous1 _Anonymous1_e__Union
	Anonymous2 _Anonymous2_e__Union
	Anonymous3 _Anonymous3_e__Union
}

type KSDS3D_BUFFER_ALL struct {
	Position DS3DVECTOR
	Velocity DS3DVECTOR
	InsideConeAngle uint32
	OutsideConeAngle uint32
	ConeOrientation DS3DVECTOR
	ConeOutsideVolume int32
	MinDistance float32
	MaxDistance float32
	Mode uint32
}
type
  DS3DVECTOR = record
    Anonymous1: _Anonymous1_e__Union;
    Anonymous2: _Anonymous2_e__Union;
    Anonymous3: _Anonymous3_e__Union;
  end;

  KSDS3D_BUFFER_ALL = record
    Position: DS3DVECTOR;
    Velocity: DS3DVECTOR;
    InsideConeAngle: DWORD;
    OutsideConeAngle: DWORD;
    ConeOrientation: DS3DVECTOR;
    ConeOutsideVolume: Integer;
    MinDistance: Single;
    MaxDistance: Single;
    Mode: DWORD;
  end;
const DS3DVECTOR = extern struct {
    Anonymous1: _Anonymous1_e__Union,
    Anonymous2: _Anonymous2_e__Union,
    Anonymous3: _Anonymous3_e__Union,
};

const KSDS3D_BUFFER_ALL = extern struct {
    Position: DS3DVECTOR,
    Velocity: DS3DVECTOR,
    InsideConeAngle: u32,
    OutsideConeAngle: u32,
    ConeOrientation: DS3DVECTOR,
    ConeOutsideVolume: i32,
    MinDistance: f32,
    MaxDistance: f32,
    Mode: u32,
};
type
  DS3DVECTOR {.bycopy.} = object
    Anonymous1: _Anonymous1_e__Union
    Anonymous2: _Anonymous2_e__Union
    Anonymous3: _Anonymous3_e__Union

  KSDS3D_BUFFER_ALL {.bycopy.} = object
    Position: DS3DVECTOR
    Velocity: DS3DVECTOR
    InsideConeAngle: uint32
    OutsideConeAngle: uint32
    ConeOrientation: DS3DVECTOR
    ConeOutsideVolume: int32
    MinDistance: float32
    MaxDistance: float32
    Mode: uint32
struct DS3DVECTOR
{
    _Anonymous1_e__Union Anonymous1;
    _Anonymous2_e__Union Anonymous2;
    _Anonymous3_e__Union Anonymous3;
}

struct KSDS3D_BUFFER_ALL
{
    DS3DVECTOR Position;
    DS3DVECTOR Velocity;
    uint InsideConeAngle;
    uint OutsideConeAngle;
    DS3DVECTOR ConeOrientation;
    int ConeOutsideVolume;
    float MinDistance;
    float MaxDistance;
    uint Mode;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; KSDS3D_BUFFER_ALL サイズ: 60 バイト(x64)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; Position : DS3DVECTOR (+0, 12byte)  varptr(st)+0 を基点に操作(12byte:入れ子/配列)
; Velocity : DS3DVECTOR (+12, 12byte)  varptr(st)+12 を基点に操作(12byte:入れ子/配列)
; InsideConeAngle : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; OutsideConeAngle : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; ConeOrientation : DS3DVECTOR (+32, 12byte)  varptr(st)+32 を基点に操作(12byte:入れ子/配列)
; ConeOutsideVolume : INT (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; MinDistance : FLOAT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; MaxDistance : FLOAT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; Mode : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global DS3DVECTOR
    #field byte Anonymous1 4
    #field byte Anonymous2 4
    #field byte Anonymous3 4
#endstruct

#defstruct global KSDS3D_BUFFER_ALL
    #field DS3DVECTOR Position
    #field DS3DVECTOR Velocity
    #field int InsideConeAngle
    #field int OutsideConeAngle
    #field DS3DVECTOR ConeOrientation
    #field int ConeOutsideVolume
    #field float MinDistance
    #field float MaxDistance
    #field int Mode
#endstruct

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