mfcam_audio_open

オーディオデバイスを開いて worker thread 起動

mfcam_audio_open p1, p2, p3, p4

p1 : デバイスインデックス (mfcam_audio_count で取得)
p2 : sample rate (例 16000 / 44100 / 48000、0 で 48000)
p3 : channels (1=mono / 2=stereo、0 で 2)
p4 : bits per sample (8/16/24/32、0 で 16)

(プラグイン / モジュール : hspmfcam.dll)

解説

オーディオデバイスを open して MF SourceReader を起動。要求された PCM
フォーマットがネイティブと違っていても MF の Audio Resampler MFT が
自動で挿入されて変換されます (得られた format は mfcam_audio_get_format
で確認可能)。

戻り値: ハンドル (>=0) / -1 失敗 / -2 フォーマット非対応

最大 64 デバイス並列。

関連項目

mfcam_audio_closeオーディオデバイスを閉じる(hspmfcam.dll)
mfcam_audio_get_format実際に得られた sample rate / ch / bits を取得(hspmfcam.dll)

情報

プラグイン / モジュールhspmfcam.dll
バージョン1.0
作成日2026-04-14
著作者IronHSP / hspmfcam
URLhttps://github.com/inovia/IronHSP
備考hspmfcam.dll は Microsoft Media Foundation (MF) を直接ラップして、
Webcam や仮想カメラ (OBS/NDI)、キャプチャカード (Magewell/Elgato/Blackmagic)
からの映像取り込み・録画を 1 行で行えるようにする C++ 製ヘルパ DLL です。

特徴:
- 内部で worker thread + child window を作成 (MFPlay と同じ方式)
- HSP main thread が title bar drag 等で停止しても映像は止まらない
- 最大 256 デバイスを同時に open 可能
- 自動デインターレース (キャプチャカードの 1080i 等にも対応)
- PNG/JPEG/BMP/GIF/TIFF スナップショット保存 (WIC)
- H.264/HEVC/WMV9/VP9/MJPG 録画 + AAC/WMA/FLAC/MP3 同時録音
- カメラプロパティ (明るさ/露出/フォーカス等) アクセス

HSP 側からは package/win32/common/iron_camera_mf.hsp を include して
iron_cam_* 系のラッパ命令で扱うのが推奨です (raw API は mfcam_* 系)。
タイプ拡張命令
グループhspmfcam ― audio capture
対応環境
  • その他 : Win32 / Win64
hs ファイルhsphelp\hspmfcam.hs