Win32 API 日本語リファレンス
ホーム › System.WinRT.Xaml › IVirtualSurfaceImageSourceNative

IVirtualSurfaceImageSourceNative

COM
📘 Microsoft Learn (日本語) · English
IIDe9550983-360b-4f53-b391-afd695078691継承元ISurfaceImageSourceNative自前メソッド開始 vtbl6

公式ドキュメント

DirectX による描画用の、大きな(画面サイズより大きい)共有サーフェスの実装を提供します。

解説(Remarks)

このインターフェースは、Windows::UI::Xaml::Media::Imaging::VirtualSurfaceImageSource Windows ランタイム型のネイティブ実装を提供します。IVirtualSurfaceImageSourceNative へのポインターを取得するには、VirtualSurfaceImageSource インスタンスを IInspectable または IUnknown にキャストし、QueryInterface を呼び出す必要があります。


Microsoft::WRL::ComPtr<IVirtualSurfaceImageSourceNative>	m_vsisNative;
// ...
IInspectable* vsisInspectable = (IInspectable*) reinterpret_cast<IInspectable*>(virtualSurfaceImageSource);
vsisInspectable->QueryInterface(__uuidof(IVirtualSurfaceImageSourceNative), (void **)&m_vsisNative)

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 6 HRESULT Invalidate(RECT updateRect)

共有サーフェスの特定の領域を、描画のために無効化(再描画対象として指定)します。

updateRectRECTin無効化するサーフェスの領域。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 7 HRESULT GetUpdateRectCount(DWORD* count)

更新が必要なサーフェスの領域の総数を取得します。

countDWORD*out更新が必要な領域の数を受け取ります。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 8 HRESULT GetUpdateRects(RECT* updates, DWORD count)

共有サーフェス上で更新が必要な領域の集合を取得します。

updatesRECT*out更新が必要な領域の数。この値は GetUpdateRectCount を呼び出して取得します。
countDWORDin更新が必要な領域の一覧を受け取ります。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 9 HRESULT GetVisibleBounds(RECT* bounds)

共有サーフェスの可視領域の境界を取得します。

boundsRECT*out共有サーフェスの可視領域を指定する矩形を受け取ります。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 10 HRESULT RegisterForUpdatesNeeded(IVirtualSurfaceUpdatesCallbackNative* callback)

共有サーフェスの更新が要求されたときに描画を実行するコールバックを登録します。

callbackIVirtualSurfaceUpdatesCallbackNative*inoptionalIVirtualSurfaceUpdatesCallbackNative の実装へのポインター。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 11 HRESULT Resize(INT newWidth, INT newHeight)

サーフェスのサイズを変更します。

newWidthINTinサーフェスの新しい幅。
newHeightINTinサーフェスの新しい高さ。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IVirtualSurfaceImageSourceNative "{E9550983-360B-4F53-B391-AFD695078691}"
#usecom global IVirtualSurfaceImageSourceNative IID_IVirtualSurfaceImageSourceNative "{}"
#comfunc global IVirtualSurfaceImageSourceNative_Invalidate                6 int
#comfunc global IVirtualSurfaceImageSourceNative_GetUpdateRectCount        7 var
#comfunc global IVirtualSurfaceImageSourceNative_GetUpdateRects            8 var,int
#comfunc global IVirtualSurfaceImageSourceNative_GetVisibleBounds          9 var
#comfunc global IVirtualSurfaceImageSourceNative_RegisterForUpdatesNeeded  10 sptr
#comfunc global IVirtualSurfaceImageSourceNative_Resize                    11 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。