指定ウィンドウのキャプチャを開始
wgc_start_window hwnd, var_handle
hwnd : キャプチャ対象ウィンドウハンドル (int) var_handle : セッションハンドルを受け取る整数変数
(プラグイン / モジュール : hspwgcapture.dll)
GraphicsCaptureItem::CreateForWindow で指定 HWND のキャプチャ
セッションを作成し、Direct3D11CaptureFramePool を CreateFreeThreaded
で生成したのち、GraphicsCaptureSession::StartCapture() を呼びます。
var_handle に 0 以上の内部セッションスロット番号が格納されます。
-1 = 失敗 / -2 = 無効な HWND。
同時に最大 4 セッションを保持できます。
| wgc_start_monitor | 指定モニタ全体のキャプチャを開始 | (hspwgcapture.dll) |
| wgc_stop | キャプチャ停止 | (hspwgcapture.dll) |
| wgc_grab_frame | 最新フレームを BGRA バイト列で取得 | (hspwgcapture.dll) |
| プラグイン / モジュール | hspwgcapture.dll |
| バージョン | 1.0 |
| 作成日 | 2026-04-15 |
| 著作者 | IronHSP / hspwgcapture |
| URL | https://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 ― キャプチャ |
| 対応環境 |
|
| hs ファイル | hsphelp\hspwgcapture.hs |