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

acmFormatSuggest

関数
指定したソース形式に適した変換先の波形フォーマットを提案する。
DLLMSACM32.dll呼出規約winapi対応OSWindows 2000 以降

シグネチャ

// MSACM32.dll
#include <windows.h>

DWORD acmFormatSuggest(
    HACMDRIVER had,
    WAVEFORMATEX* pwfxSrc,
    WAVEFORMATEX* pwfxDst,
    DWORD cbwfxDst,
    DWORD fdwSuggest
);

パラメーター

名前方向
hadHACMDRIVERin
pwfxSrcWAVEFORMATEX*inout
pwfxDstWAVEFORMATEX*inout
cbwfxDstDWORDin
fdwSuggestDWORDin

戻り値の型: DWORD

各言語での呼び出し定義

// MSACM32.dll
#include <windows.h>

DWORD acmFormatSuggest(
    HACMDRIVER had,
    WAVEFORMATEX* pwfxSrc,
    WAVEFORMATEX* pwfxDst,
    DWORD cbwfxDst,
    DWORD fdwSuggest
);
[DllImport("MSACM32.dll", ExactSpelling = true)]
static extern uint acmFormatSuggest(
    IntPtr had,   // HACMDRIVER
    IntPtr pwfxSrc,   // WAVEFORMATEX* in/out
    IntPtr pwfxDst,   // WAVEFORMATEX* in/out
    uint cbwfxDst,   // DWORD
    uint fdwSuggest   // DWORD
);
<DllImport("MSACM32.dll", ExactSpelling:=True)>
Public Shared Function acmFormatSuggest(
    had As IntPtr,   ' HACMDRIVER
    pwfxSrc As IntPtr,   ' WAVEFORMATEX* in/out
    pwfxDst As IntPtr,   ' WAVEFORMATEX* in/out
    cbwfxDst As UInteger,   ' DWORD
    fdwSuggest As UInteger   ' DWORD
) As UInteger
End Function
' had : HACMDRIVER
' pwfxSrc : WAVEFORMATEX* in/out
' pwfxDst : WAVEFORMATEX* in/out
' cbwfxDst : DWORD
' fdwSuggest : DWORD
Declare PtrSafe Function acmFormatSuggest Lib "msacm32" ( _
    ByVal had As LongPtr, _
    ByVal pwfxSrc As LongPtr, _
    ByVal pwfxDst As LongPtr, _
    ByVal cbwfxDst As Long, _
    ByVal fdwSuggest As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。
import ctypes
from ctypes import wintypes

acmFormatSuggest = ctypes.windll.msacm32.acmFormatSuggest
acmFormatSuggest.restype = wintypes.DWORD
acmFormatSuggest.argtypes = [
    wintypes.HANDLE,  # had : HACMDRIVER
    ctypes.c_void_p,  # pwfxSrc : WAVEFORMATEX* in/out
    ctypes.c_void_p,  # pwfxDst : WAVEFORMATEX* in/out
    wintypes.DWORD,  # cbwfxDst : DWORD
    wintypes.DWORD,  # fdwSuggest : DWORD
]
require 'fiddle'
require 'fiddle/import'

lib = Fiddle.dlopen('MSACM32.dll')
acmFormatSuggest = Fiddle::Function.new(
  lib['acmFormatSuggest'],
  [
    Fiddle::TYPE_VOIDP,  # had : HACMDRIVER
    Fiddle::TYPE_VOIDP,  # pwfxSrc : WAVEFORMATEX* in/out
    Fiddle::TYPE_VOIDP,  # pwfxDst : WAVEFORMATEX* in/out
    -Fiddle::TYPE_INT,  # cbwfxDst : DWORD
    -Fiddle::TYPE_INT,  # fdwSuggest : DWORD
  ],
  -Fiddle::TYPE_INT)
#[link(name = "msacm32")]
extern "system" {
    fn acmFormatSuggest(
        had: *mut core::ffi::c_void,  // HACMDRIVER
        pwfxSrc: *mut WAVEFORMATEX,  // WAVEFORMATEX* in/out
        pwfxDst: *mut WAVEFORMATEX,  // WAVEFORMATEX* in/out
        cbwfxDst: u32,  // DWORD
        fdwSuggest: u32  // DWORD
    ) -> u32;
}
// crates: windows-sys provides ready-made bindings for this API.
$sig = @"
[DllImport("MSACM32.dll")]
public static extern uint acmFormatSuggest(IntPtr had, IntPtr pwfxSrc, IntPtr pwfxDst, uint cbwfxDst, uint fdwSuggest);
"@
$api = Add-Type -MemberDefinition $sig -Name 'MSACM32_acmFormatSuggest' -Namespace Win32 -PassThru
# $api::acmFormatSuggest(had, pwfxSrc, pwfxDst, cbwfxDst, fdwSuggest)
#uselib "MSACM32.dll"
#func global acmFormatSuggest "acmFormatSuggest" sptr, sptr, sptr, sptr, sptr
; acmFormatSuggest had, varptr(pwfxSrc), varptr(pwfxDst), cbwfxDst, fdwSuggest   ; 戻り値は stat
; had : HACMDRIVER -> "sptr"
; pwfxSrc : WAVEFORMATEX* in/out -> "sptr"
; pwfxDst : WAVEFORMATEX* in/out -> "sptr"
; cbwfxDst : DWORD -> "sptr"
; fdwSuggest : DWORD -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。
出力引数:
#uselib "MSACM32.dll"
#cfunc global acmFormatSuggest "acmFormatSuggest" sptr, var, var, int, int
; res = acmFormatSuggest(had, pwfxSrc, pwfxDst, cbwfxDst, fdwSuggest)
; had : HACMDRIVER -> "sptr"
; pwfxSrc : WAVEFORMATEX* in/out -> "var"
; pwfxDst : WAVEFORMATEX* in/out -> "var"
; cbwfxDst : DWORD -> "int"
; fdwSuggest : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
出力引数:
; DWORD acmFormatSuggest(HACMDRIVER had, WAVEFORMATEX* pwfxSrc, WAVEFORMATEX* pwfxDst, DWORD cbwfxDst, DWORD fdwSuggest)
#uselib "MSACM32.dll"
#cfunc global acmFormatSuggest "acmFormatSuggest" intptr, var, var, int, int
; res = acmFormatSuggest(had, pwfxSrc, pwfxDst, cbwfxDst, fdwSuggest)
; had : HACMDRIVER -> "intptr"
; pwfxSrc : WAVEFORMATEX* in/out -> "var"
; pwfxDst : WAVEFORMATEX* in/out -> "var"
; cbwfxDst : DWORD -> "int"
; fdwSuggest : DWORD -> "int"
; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。
import (
	"golang.org/x/sys/windows"
	"unsafe"
)

var (
	msacm32 = windows.NewLazySystemDLL("MSACM32.dll")
	procacmFormatSuggest = msacm32.NewProc("acmFormatSuggest")
)

// had (HACMDRIVER), pwfxSrc (WAVEFORMATEX* in/out), pwfxDst (WAVEFORMATEX* in/out), cbwfxDst (DWORD), fdwSuggest (DWORD)
r1, _, err := procacmFormatSuggest.Call(
	uintptr(had),
	uintptr(pwfxSrc),
	uintptr(pwfxDst),
	uintptr(cbwfxDst),
	uintptr(fdwSuggest),
)
_ = err  // syscall.Errno (valid when the call sets last-error)
_ = r1   // DWORD
function acmFormatSuggest(
  had: THandle;   // HACMDRIVER
  pwfxSrc: Pointer;   // WAVEFORMATEX* in/out
  pwfxDst: Pointer;   // WAVEFORMATEX* in/out
  cbwfxDst: DWORD;   // DWORD
  fdwSuggest: DWORD   // DWORD
): DWORD; stdcall;
  external 'MSACM32.dll' name 'acmFormatSuggest';
result := DllCall("MSACM32\acmFormatSuggest"
    , "Ptr", had   ; HACMDRIVER
    , "Ptr", pwfxSrc   ; WAVEFORMATEX* in/out
    , "Ptr", pwfxDst   ; WAVEFORMATEX* in/out
    , "UInt", cbwfxDst   ; DWORD
    , "UInt", fdwSuggest   ; DWORD
    , "UInt")   ; return: DWORD
●acmFormatSuggest(had, pwfxSrc, pwfxDst, cbwfxDst, fdwSuggest) = DLL("MSACM32.dll", "dword acmFormatSuggest(void*, void*, void*, dword, dword)")
# 呼び出し: acmFormatSuggest(had, pwfxSrc, pwfxDst, cbwfxDst, fdwSuggest)
# had : HACMDRIVER -> "void*"
# pwfxSrc : WAVEFORMATEX* in/out -> "void*"
# pwfxDst : WAVEFORMATEX* in/out -> "void*"
# cbwfxDst : DWORD -> "dword"
# fdwSuggest : DWORD -> "dword"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。