wgc_save_png

最新フレームを PNG ファイルに保存

wgc_save_png handle, "path"

handle : セッションハンドル
path   : 出力ファイルパス

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

解説

wgc_grab_frame と同じ方法で最新フレームを取得し、その場で
WIC (Windows Imaging Component) の IWICBitmapEncoder を使って
PNG エンコードしてファイルに書き出します。

戻り値 (stat):
  0  : 成功
 負値 : 失敗

関連項目

wgc_grab_frame最新フレームを BGRA バイト列で取得(hspwgcapture.dll)

サンプル逆引き (1)

sample_wgcapture.hsp

情報

プラグイン / モジュールhspwgcapture.dll
バージョン1.0
作成日2026-04-15
著作者IronHSP / hspwgcapture
URLhttps://github.com/inovia/IronHSP
備考hspwgcapture.dll は Windows 10 1903 (19H1) 以降に搭載された
Windows.Graphics.Capture API (WinRT) を HSP3 から直接呼び出す
ためのプラグインです。

Windows.Graphics.Capture API はモダンな DWM 連携キャプチャを
提供し、従来の BitBlt / PrintWindow よりも高フレームレートで
GPU 上のウィンドウ / モニタ内容を取得できます。ハードウェア
アクセラレートされた D3D11 テクスチャ経由でピクセルが渡される
ため、全画面ゲームやハードウェア合成されたウィンドウでも正しく
キャプチャできます。

実装は C++/WinRT + D3D11 + WIC で、非同期 API は使用していま
せん (Direct3D11CaptureFramePool::CreateFreeThreaded の同期
ポーリング型)。HSP 側からは通常の同期命令として扱えます。

注意: Windows.Graphics.Capture を利用すると、対象ウィンドウ
に黄色の「キャプチャ中」ハイライト枠が表示されるのが既定動作
です (Windows 11 以降は設定で無効化可能)。
タイプ拡張命令
グループhspwgcapture ― フレーム取得
対応環境
  • その他 : Win32 / Win64 (Windows 10 1903 以降)
hs ファイルhsphelp\hspwgcapture.hs