ホーム › Media.Audio.DirectMusic › DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA

DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA

構造体

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

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

フィールド

フィールド	型	サイズ	x64	x86	説明
DeviceId	GUID	16	+0	+0	デバイスを一意に識別するGUID。
DescriptionA	CHAR	256	+16	+16	デバイスの説明文字列(ANSI、固定長配列)。
DescriptionW	WCHAR	512	+272	+272	デバイスの説明文字列(Unicode、固定長配列)。
ModuleA	CHAR	260	+784	+784	デバイスドライバモジュール名(ANSI、固定長配列)。
ModuleW	WCHAR	520	+1044	+1044	デバイスドライバモジュール名(Unicode、固定長配列)。
Type	DIRECTSOUNDDEVICE_TYPE	4	+1564	+1564	デバイスの種類(エミュレート/VxD/WDM、DIRECTSOUNDDEVICE_TYPE)。
DataFlow	DIRECTSOUNDDEVICE_DATAFLOW	4	+1568	+1568	データフローの方向(再生/録音、DIRECTSOUNDDEVICE_DATAFLOW)。
WaveDeviceId	DWORD	4	+1572	+1572	対応するwaveデバイスのID番号。
Devnode	DWORD	4	+1576	+1576	デバイスのデバイスノード(devnode)識別子。

各言語での定義

#include <windows.h>

// DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA  (x64 1580 / x86 1580 バイト)
typedef struct DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA {
    GUID DeviceId;
    CHAR DescriptionA[256];
    WCHAR DescriptionW[256];
    CHAR ModuleA[260];
    WCHAR ModuleW[260];
    DIRECTSOUNDDEVICE_TYPE Type;
    DIRECTSOUNDDEVICE_DATAFLOW DataFlow;
    DWORD WaveDeviceId;
    DWORD Devnode;
} DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA;

using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA
{
    public Guid DeviceId;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 256)] public sbyte[] DescriptionA;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string DescriptionW;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 260)] public sbyte[] ModuleA;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 260)] public string ModuleW;
    public int Type;
    public int DataFlow;
    public uint WaveDeviceId;
    public uint Devnode;
}

Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA
    Public DeviceId As Guid
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=256)> Public DescriptionA() As SByte
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=256)> Public DescriptionW As String
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=260)> Public ModuleA() As SByte
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=260)> Public ModuleW As String
    Public Type As Integer
    Public DataFlow As Integer
    Public WaveDeviceId As UInteger
    Public Devnode As UInteger
End Structure

import ctypes
from ctypes import wintypes

class DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA(ctypes.Structure):
    _fields_ = [
        ("DeviceId", GUID),
        ("DescriptionA", ctypes.c_byte * 256),
        ("DescriptionW", ctypes.c_wchar * 256),
        ("ModuleA", ctypes.c_byte * 260),
        ("ModuleW", ctypes.c_wchar * 260),
        ("Type", ctypes.c_int),
        ("DataFlow", ctypes.c_int),
        ("WaveDeviceId", wintypes.DWORD),
        ("Devnode", wintypes.DWORD),
    ]

#[repr(C)]
pub struct DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA {
    pub DeviceId: GUID,
    pub DescriptionA: [i8; 256],
    pub DescriptionW: [u16; 256],
    pub ModuleA: [i8; 260],
    pub ModuleW: [u16; 260],
    pub Type: i32,
    pub DataFlow: i32,
    pub WaveDeviceId: u32,
    pub Devnode: u32,
}

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

type DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA struct {
	DeviceId windows.GUID
	DescriptionA [256]int8
	DescriptionW [256]uint16
	ModuleA [260]int8
	ModuleW [260]uint16
	Type int32
	DataFlow int32
	WaveDeviceId uint32
	Devnode uint32
}

type
  DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA = record
    DeviceId: TGUID;
    DescriptionA: array[0..255] of Shortint;
    DescriptionW: array[0..255] of WideChar;
    ModuleA: array[0..259] of Shortint;
    ModuleW: array[0..259] of WideChar;
    Type: Integer;
    DataFlow: Integer;
    WaveDeviceId: DWORD;
    Devnode: DWORD;
  end;

const DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA = extern struct {
    DeviceId: GUID,
    DescriptionA: [256]i8,
    DescriptionW: [256]u16,
    ModuleA: [260]i8,
    ModuleW: [260]u16,
    Type: i32,
    DataFlow: i32,
    WaveDeviceId: u32,
    Devnode: u32,
};

type
  DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA {.bycopy.} = object
    DeviceId: GUID
    DescriptionA: array[256, int8]
    DescriptionW: array[256, uint16]
    ModuleA: array[260, int8]
    ModuleW: array[260, uint16]
    Type: int32
    DataFlow: int32
    WaveDeviceId: uint32
    Devnode: uint32

struct DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA
{
    GUID DeviceId;
    byte[256] DescriptionA;
    wchar[256] DescriptionW;
    byte[260] ModuleA;
    wchar[260] ModuleW;
    int Type;
    int DataFlow;
    uint WaveDeviceId;
    uint Devnode;
}

HSP用定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA サイズ: 1580 バイト(x64)
dim st, 395    ; 4byte整数×395(構造体サイズ 1580 / 4 切り上げ)
; DeviceId : GUID (+0, 16byte)  varptr(st)+0 を基点に操作(16byte:入れ子/配列)
; DescriptionA : CHAR (+16, 256byte)  varptr(st)+16 を基点に操作(256byte:入れ子/配列)
; DescriptionW : WCHAR (+272, 512byte)  varptr(st)+272 を基点に操作(512byte:入れ子/配列)
; ModuleA : CHAR (+784, 260byte)  varptr(st)+784 を基点に操作(260byte:入れ子/配列)
; ModuleW : WCHAR (+1044, 520byte)  varptr(st)+1044 を基点に操作(520byte:入れ子/配列)
; Type : DIRECTSOUNDDEVICE_TYPE (+1564, 4byte)  st.391 = 値  /  値 = st.391   (lpoke/lpeek も可)
; DataFlow : DIRECTSOUNDDEVICE_DATAFLOW (+1568, 4byte)  st.392 = 値  /  値 = st.392   (lpoke/lpeek も可)
; WaveDeviceId : DWORD (+1572, 4byte)  st.393 = 値  /  値 = st.393   (lpoke/lpeek も可)
; Devnode : DWORD (+1576, 4byte)  st.394 = 値  /  値 = st.394   (lpoke/lpeek も可)
; ※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 DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA
    #field GUID DeviceId
    #field byte DescriptionA 256
    #field wchar DescriptionW 256
    #field byte ModuleA 260
    #field wchar ModuleW 260
    #field int Type
    #field int DataFlow
    #field int WaveDeviceId
    #field int Devnode
#endstruct

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

DSPROPERTY_DIRECTSOUNDDEVICE_DESCRIPTION_1_DATA

フィールド

各言語での定義

HSP用 定義

HSP用定義