ホーム › Media.Audio.DirectMusic › DMUS_PORTCAPS

DMUS_PORTCAPS

構造体

サイズx64: 308 バイト / x86: 308 バイト

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

フィールド

フィールド	型	サイズ	x64	x86	説明
dwSize	DWORD	4	+0	+0	この構造体のバイトサイズ。呼び出し前に設定する。
dwFlags	DWORD	4	+4	+4	ポートの能力を示すビットフラグ(DMUS_PC_*)。
guidPort	GUID	16	+8	+8	ポートを一意に識別するGUID。
dwClass	DWORD	4	+24	+24	ポートのクラス(入力/出力など、DMUS_PC_INPUTCLASS等)。
dwType	DWORD	4	+28	+28	ポートの種類(WINMM/ユーザーモードシンセ等、DMUS_PORT_*)。
dwMemorySize	DWORD	4	+32	+32	オンボードサンプルメモリのバイト容量。0は無制限/システムメモリ使用。
dwMaxChannelGroups	DWORD	4	+36	+36	同時に扱える最大チャンネルグループ数。
dwMaxVoices	DWORD	4	+40	+40	同時発音可能な最大ボイス数。
dwMaxAudioChannels	DWORD	4	+44	+44	出力可能な最大オーディオチャンネル数。
dwEffectFlags	DWORD	4	+48	+48	サポートするエフェクトを示すビットフラグ(DMUS_EFFECT_*)。
wszDescription	WCHAR	256	+52	+52	ポートの説明文字列(Unicode、固定長配列)。

各言語での定義

#include <windows.h>

// DMUS_PORTCAPS  (x64 308 / x86 308 バイト)
typedef struct DMUS_PORTCAPS {
    DWORD dwSize;
    DWORD dwFlags;
    GUID guidPort;
    DWORD dwClass;
    DWORD dwType;
    DWORD dwMemorySize;
    DWORD dwMaxChannelGroups;
    DWORD dwMaxVoices;
    DWORD dwMaxAudioChannels;
    DWORD dwEffectFlags;
    WCHAR wszDescription[128];
} DMUS_PORTCAPS;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DMUS_PORTCAPS
{
    public uint dwSize;
    public uint dwFlags;
    public Guid guidPort;
    public uint dwClass;
    public uint dwType;
    public uint dwMemorySize;
    public uint dwMaxChannelGroups;
    public uint dwMaxVoices;
    public uint dwMaxAudioChannels;
    public uint dwEffectFlags;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 128)] public string wszDescription;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DMUS_PORTCAPS
    Public dwSize As UInteger
    Public dwFlags As UInteger
    Public guidPort As Guid
    Public dwClass As UInteger
    Public dwType As UInteger
    Public dwMemorySize As UInteger
    Public dwMaxChannelGroups As UInteger
    Public dwMaxVoices As UInteger
    Public dwMaxAudioChannels As UInteger
    Public dwEffectFlags As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=128)> Public wszDescription As String
End Structure

import ctypes
from ctypes import wintypes

class DMUS_PORTCAPS(ctypes.Structure):
    _fields_ = [
        ("dwSize", wintypes.DWORD),
        ("dwFlags", wintypes.DWORD),
        ("guidPort", GUID),
        ("dwClass", wintypes.DWORD),
        ("dwType", wintypes.DWORD),
        ("dwMemorySize", wintypes.DWORD),
        ("dwMaxChannelGroups", wintypes.DWORD),
        ("dwMaxVoices", wintypes.DWORD),
        ("dwMaxAudioChannels", wintypes.DWORD),
        ("dwEffectFlags", wintypes.DWORD),
        ("wszDescription", ctypes.c_wchar * 128),
    ]

#[repr(C)]
pub struct DMUS_PORTCAPS {
    pub dwSize: u32,
    pub dwFlags: u32,
    pub guidPort: GUID,
    pub dwClass: u32,
    pub dwType: u32,
    pub dwMemorySize: u32,
    pub dwMaxChannelGroups: u32,
    pub dwMaxVoices: u32,
    pub dwMaxAudioChannels: u32,
    pub dwEffectFlags: u32,
    pub wszDescription: [u16; 128],
}

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

type DMUS_PORTCAPS struct {
	dwSize uint32
	dwFlags uint32
	guidPort windows.GUID
	dwClass uint32
	dwType uint32
	dwMemorySize uint32
	dwMaxChannelGroups uint32
	dwMaxVoices uint32
	dwMaxAudioChannels uint32
	dwEffectFlags uint32
	wszDescription [128]uint16
}

type
  DMUS_PORTCAPS = record
    dwSize: DWORD;
    dwFlags: DWORD;
    guidPort: TGUID;
    dwClass: DWORD;
    dwType: DWORD;
    dwMemorySize: DWORD;
    dwMaxChannelGroups: DWORD;
    dwMaxVoices: DWORD;
    dwMaxAudioChannels: DWORD;
    dwEffectFlags: DWORD;
    wszDescription: array[0..127] of WideChar;
  end;

const DMUS_PORTCAPS = extern struct {
    dwSize: u32,
    dwFlags: u32,
    guidPort: GUID,
    dwClass: u32,
    dwType: u32,
    dwMemorySize: u32,
    dwMaxChannelGroups: u32,
    dwMaxVoices: u32,
    dwMaxAudioChannels: u32,
    dwEffectFlags: u32,
    wszDescription: [128]u16,
};

type
  DMUS_PORTCAPS {.bycopy.} = object
    dwSize: uint32
    dwFlags: uint32
    guidPort: GUID
    dwClass: uint32
    dwType: uint32
    dwMemorySize: uint32
    dwMaxChannelGroups: uint32
    dwMaxVoices: uint32
    dwMaxAudioChannels: uint32
    dwEffectFlags: uint32
    wszDescription: array[128, uint16]

struct DMUS_PORTCAPS
{
    uint dwSize;
    uint dwFlags;
    GUID guidPort;
    uint dwClass;
    uint dwType;
    uint dwMemorySize;
    uint dwMaxChannelGroups;
    uint dwMaxVoices;
    uint dwMaxAudioChannels;
    uint dwEffectFlags;
    wchar[128] wszDescription;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DMUS_PORTCAPS サイズ: 308 バイト(x64)
dim st, 77    ; 4byte整数×77(構造体サイズ 308 / 4 切り上げ)
; dwSize : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; dwFlags : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; guidPort : GUID (+8, 16byte)  varptr(st)+8 を基点に操作(16byte:入れ子/配列)
; dwClass : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; dwType : DWORD (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; dwMemorySize : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; dwMaxChannelGroups : DWORD (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; dwMaxVoices : DWORD (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; dwMaxAudioChannels : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; dwEffectFlags : DWORD (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; wszDescription : WCHAR (+52, 256byte)  varptr(st)+52 を基点に操作(256byte:入れ子/配列)
; ※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 DMUS_PORTCAPS
    #field int dwSize
    #field int dwFlags
    #field GUID guidPort
    #field int dwClass
    #field int dwType
    #field int dwMemorySize
    #field int dwMaxChannelGroups
    #field int dwMaxVoices
    #field int dwMaxAudioChannels
    #field int dwEffectFlags
    #field wchar wszDescription 128
#endstruct

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

DMUS_PORTCAPS

フィールド

各言語での定義

HSP用 定義

HSP用定義