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

ACMFILTERCHOOSEA

構造体
サイズx64: 268 バイト / x86: 232 バイトパッキング1

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

フィールド

フィールドサイズx64x86説明
cbStructDWORD4+0+0この構造体のサイズをバイト単位で示す。事前に設定が必要である。
fdwStyleDWORD4+4+4ダイアログの動作を制御するスタイルフラグ(ACMFILTERCHOOSE_STYLEF_*)を示す。
hwndOwnerHWND8/4+8+8ダイアログ所有ウィンドウのハンドル。NULL可。
pwfltrWAVEFILTER*8/4+16+12選択結果を受け取るWAVEFILTER構造体へのポインター。
cbwfltrDWORD4+24+16pwfltrバッファのサイズをバイト単位で示す。
pszTitleLPSTR8/4+28+20ダイアログのタイトル文字列(ANSI)へのポインター。NULL可。
szFilterTagCHAR48+36+24選択されたフィルタータグの説明を受け取るANSI文字配列。
szFilterCHAR128+84+72選択されたフィルターの説明を受け取るANSI文字配列。
pszNameLPSTR8/4+212+200フィルター名の入出力に使うANSI文字列バッファへのポインター。
cchNameDWORD4+220+204pszNameバッファの文字数を示す。
fdwEnumDWORD4+224+208列挙対象を制限するフラグ(ACM_FILTERENUMF_*)を示す。
pwfltrEnumWAVEFILTER*8/4+228+212列挙の絞り込みに使うWAVEFILTER構造体へのポインター。NULL可。
hInstanceHINSTANCE8/4+236+216カスタムダイアログテンプレートを含むモジュールのインスタンスハンドル。
pszTemplateNameLPSTR8/4+244+220カスタムダイアログテンプレート名(ANSI)へのポインター。NULL可。
lCustDataLPARAM8/4+252+224フックプロシージャに渡すアプリ定義のデータ値。
pfnHookACMFILTERCHOOSEHOOKPROCA8/4+260+228ダイアログメッセージを処理するフックプロシージャへのポインター。NULL可。

各言語での定義

#include <windows.h>

// ACMFILTERCHOOSEA  (x64 268 / x86 232 バイト)
#pragma pack(push, 1)
typedef struct ACMFILTERCHOOSEA {
    DWORD cbStruct;
    DWORD fdwStyle;
    HWND hwndOwner;
    WAVEFILTER* pwfltr;
    DWORD cbwfltr;
    LPSTR pszTitle;
    CHAR szFilterTag[48];
    CHAR szFilter[128];
    LPSTR pszName;
    DWORD cchName;
    DWORD fdwEnum;
    WAVEFILTER* pwfltrEnum;
    HINSTANCE hInstance;
    LPSTR pszTemplateName;
    LPARAM lCustData;
    ACMFILTERCHOOSEHOOKPROCA pfnHook;
} ACMFILTERCHOOSEA;
#pragma pack(pop)
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, Pack = 1, CharSet = CharSet.Unicode)]
public struct ACMFILTERCHOOSEA
{
    public uint cbStruct;
    public uint fdwStyle;
    public IntPtr hwndOwner;
    public IntPtr pwfltr;
    public uint cbwfltr;
    public IntPtr pszTitle;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 48)] public sbyte[] szFilterTag;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 128)] public sbyte[] szFilter;
    public IntPtr pszName;
    public uint cchName;
    public uint fdwEnum;
    public IntPtr pwfltrEnum;
    public IntPtr hInstance;
    public IntPtr pszTemplateName;
    public IntPtr lCustData;
    public IntPtr pfnHook;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, Pack:=1, CharSet:=CharSet.Unicode)>
Public Structure ACMFILTERCHOOSEA
    Public cbStruct As UInteger
    Public fdwStyle As UInteger
    Public hwndOwner As IntPtr
    Public pwfltr As IntPtr
    Public cbwfltr As UInteger
    Public pszTitle As IntPtr
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=48)> Public szFilterTag() As SByte
    <MarshalAs(UnmanagedType.ByValArray, SizeConst:=128)> Public szFilter() As SByte
    Public pszName As IntPtr
    Public cchName As UInteger
    Public fdwEnum As UInteger
    Public pwfltrEnum As IntPtr
    Public hInstance As IntPtr
    Public pszTemplateName As IntPtr
    Public lCustData As IntPtr
    Public pfnHook As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class ACMFILTERCHOOSEA(ctypes.Structure):
    _pack_ = 1
    _fields_ = [
        ("cbStruct", wintypes.DWORD),
        ("fdwStyle", wintypes.DWORD),
        ("hwndOwner", ctypes.c_void_p),
        ("pwfltr", ctypes.c_void_p),
        ("cbwfltr", wintypes.DWORD),
        ("pszTitle", ctypes.c_void_p),
        ("szFilterTag", ctypes.c_byte * 48),
        ("szFilter", ctypes.c_byte * 128),
        ("pszName", ctypes.c_void_p),
        ("cchName", wintypes.DWORD),
        ("fdwEnum", wintypes.DWORD),
        ("pwfltrEnum", ctypes.c_void_p),
        ("hInstance", ctypes.c_void_p),
        ("pszTemplateName", ctypes.c_void_p),
        ("lCustData", ctypes.c_ssize_t),
        ("pfnHook", ctypes.c_void_p),
    ]
#[repr(C, packed(1))]
pub struct ACMFILTERCHOOSEA {
    pub cbStruct: u32,
    pub fdwStyle: u32,
    pub hwndOwner: *mut core::ffi::c_void,
    pub pwfltr: *mut core::ffi::c_void,
    pub cbwfltr: u32,
    pub pszTitle: *mut core::ffi::c_void,
    pub szFilterTag: [i8; 48],
    pub szFilter: [i8; 128],
    pub pszName: *mut core::ffi::c_void,
    pub cchName: u32,
    pub fdwEnum: u32,
    pub pwfltrEnum: *mut core::ffi::c_void,
    pub hInstance: *mut core::ffi::c_void,
    pub pszTemplateName: *mut core::ffi::c_void,
    pub lCustData: isize,
    pub pfnHook: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type ACMFILTERCHOOSEA struct {
	cbStruct uint32
	fdwStyle uint32
	hwndOwner uintptr
	pwfltr uintptr
	cbwfltr uint32
	pszTitle uintptr
	szFilterTag [48]int8
	szFilter [128]int8
	pszName uintptr
	cchName uint32
	fdwEnum uint32
	pwfltrEnum uintptr
	hInstance uintptr
	pszTemplateName uintptr
	lCustData uintptr
	pfnHook uintptr
}
type
  ACMFILTERCHOOSEA = packed record
    cbStruct: DWORD;
    fdwStyle: DWORD;
    hwndOwner: Pointer;
    pwfltr: Pointer;
    cbwfltr: DWORD;
    pszTitle: Pointer;
    szFilterTag: array[0..47] of Shortint;
    szFilter: array[0..127] of Shortint;
    pszName: Pointer;
    cchName: DWORD;
    fdwEnum: DWORD;
    pwfltrEnum: Pointer;
    hInstance: Pointer;
    pszTemplateName: Pointer;
    lCustData: NativeInt;
    pfnHook: Pointer;
  end;
const ACMFILTERCHOOSEA = extern struct {
    cbStruct: u32,
    fdwStyle: u32,
    hwndOwner: ?*anyopaque,
    pwfltr: ?*anyopaque,
    cbwfltr: u32,
    pszTitle: ?*anyopaque,
    szFilterTag: [48]i8,
    szFilter: [128]i8,
    pszName: ?*anyopaque,
    cchName: u32,
    fdwEnum: u32,
    pwfltrEnum: ?*anyopaque,
    hInstance: ?*anyopaque,
    pszTemplateName: ?*anyopaque,
    lCustData: isize,
    pfnHook: ?*anyopaque,
};
type
  ACMFILTERCHOOSEA {.packed.} = object
    cbStruct: uint32
    fdwStyle: uint32
    hwndOwner: pointer
    pwfltr: pointer
    cbwfltr: uint32
    pszTitle: pointer
    szFilterTag: array[48, int8]
    szFilter: array[128, int8]
    pszName: pointer
    cchName: uint32
    fdwEnum: uint32
    pwfltrEnum: pointer
    hInstance: pointer
    pszTemplateName: pointer
    lCustData: int
    pfnHook: pointer
align(1)
struct ACMFILTERCHOOSEA
{
    uint cbStruct;
    uint fdwStyle;
    void* hwndOwner;
    void* pwfltr;
    uint cbwfltr;
    void* pszTitle;
    byte[48] szFilterTag;
    byte[128] szFilter;
    void* pszName;
    uint cchName;
    uint fdwEnum;
    void* pwfltrEnum;
    void* hInstance;
    void* pszTemplateName;
    ptrdiff_t lCustData;
    void* pfnHook;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; ACMFILTERCHOOSEA サイズ: 232 バイト(x86)
dim st, 58    ; 4byte整数×58(構造体サイズ 232 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fdwStyle : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hwndOwner : HWND (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pwfltr : WAVEFILTER* (+12, 4byte)  varptr(st)+12 を基点に操作(4byte:入れ子/配列)
; cbwfltr : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pszTitle : LPSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; szFilterTag : CHAR (+24, 48byte)  varptr(st)+24 を基点に操作(48byte:入れ子/配列)
; szFilter : CHAR (+72, 128byte)  varptr(st)+72 を基点に操作(128byte:入れ子/配列)
; pszName : LPSTR (+200, 4byte)  st.50 = 値  /  値 = st.50   (lpoke/lpeek も可)
; cchName : DWORD (+204, 4byte)  st.51 = 値  /  値 = st.51   (lpoke/lpeek も可)
; fdwEnum : DWORD (+208, 4byte)  st.52 = 値  /  値 = st.52   (lpoke/lpeek も可)
; pwfltrEnum : WAVEFILTER* (+212, 4byte)  varptr(st)+212 を基点に操作(4byte:入れ子/配列)
; hInstance : HINSTANCE (+216, 4byte)  st.54 = 値  /  値 = st.54   (lpoke/lpeek も可)
; pszTemplateName : LPSTR (+220, 4byte)  st.55 = 値  /  値 = st.55   (lpoke/lpeek も可)
; lCustData : LPARAM (+224, 4byte)  st.56 = 値  /  値 = st.56   (lpoke/lpeek も可)
; pfnHook : ACMFILTERCHOOSEHOOKPROCA (+228, 4byte)  st.57 = 値  /  値 = st.57   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; ACMFILTERCHOOSEA サイズ: 268 バイト(x64)
dim st, 67    ; 4byte整数×67(構造体サイズ 268 / 4 切り上げ)
; cbStruct : DWORD (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; fdwStyle : DWORD (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; hwndOwner : HWND (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pwfltr : WAVEFILTER* (+16, 8byte)  varptr(st)+16 を基点に操作(8byte:入れ子/配列)
; cbwfltr : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; pszTitle : LPSTR (+28, 8byte)  qpoke st,28,値 / qpeek(st,28)  ※IronHSPのみ。3.7/3.8は lpoke st,28,下位 : lpoke st,32,上位
; szFilterTag : CHAR (+36, 48byte)  varptr(st)+36 を基点に操作(48byte:入れ子/配列)
; szFilter : CHAR (+84, 128byte)  varptr(st)+84 を基点に操作(128byte:入れ子/配列)
; pszName : LPSTR (+212, 8byte)  qpoke st,212,値 / qpeek(st,212)  ※IronHSPのみ。3.7/3.8は lpoke st,212,下位 : lpoke st,216,上位
; cchName : DWORD (+220, 4byte)  st.55 = 値  /  値 = st.55   (lpoke/lpeek も可)
; fdwEnum : DWORD (+224, 4byte)  st.56 = 値  /  値 = st.56   (lpoke/lpeek も可)
; pwfltrEnum : WAVEFILTER* (+228, 8byte)  varptr(st)+228 を基点に操作(8byte:入れ子/配列)
; hInstance : HINSTANCE (+236, 8byte)  qpoke st,236,値 / qpeek(st,236)  ※IronHSPのみ。3.7/3.8は lpoke st,236,下位 : lpoke st,240,上位
; pszTemplateName : LPSTR (+244, 8byte)  qpoke st,244,値 / qpeek(st,244)  ※IronHSPのみ。3.7/3.8は lpoke st,244,下位 : lpoke st,248,上位
; lCustData : LPARAM (+252, 8byte)  qpoke st,252,値 / qpeek(st,252)  ※IronHSPのみ。3.7/3.8は lpoke st,252,下位 : lpoke st,256,上位
; pfnHook : ACMFILTERCHOOSEHOOKPROCA (+260, 8byte)  qpoke st,260,値 / qpeek(st,260)  ※IronHSPのみ。3.7/3.8は lpoke st,260,下位 : lpoke st,264,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global ACMFILTERCHOOSEA, pack=1
    #field int cbStruct
    #field int fdwStyle
    #field intptr hwndOwner
    #field intptr pwfltr
    #field int cbwfltr
    #field intptr pszTitle
    #field byte szFilterTag 48
    #field byte szFilter 128
    #field intptr pszName
    #field int cchName
    #field int fdwEnum
    #field intptr pwfltrEnum
    #field intptr hInstance
    #field intptr pszTemplateName
    #field intptr lCustData
    #field intptr pfnHook
#endstruct

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