ホーム › Graphics.Dxgi › IDXGIAdapter3

IDXGIAdapter3

COM

📘 Microsoft Learn (日本語) · English

IID645967a4-1392-4310-a798-8053ce3e93fd継承元IDXGIAdapter2自前メソッド開始 vtbl12

公式ドキュメント

このインターフェースは、物理メモリのバジェット管理と予約を行うためのメモリレジデンシー関連のメソッドをいくつか追加します。

解説(Remarks)

詳細については、D3D12 ドキュメントの Residency セクションを参照してください。

メソッド 6

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

vtbl 12 HRESULT RegisterHardwareContentProtectionTeardownStatusEvent(HANDLE hEvent, DWORD* pdwCookie)

ハードウェアコンテンツ保護のティアダウンイベントの通知を受け取るために登録します。

hEvent	HANDLE	in	ハードウェアコンテンツ保護のティアダウンが発生したときにオペレーティングシステムがセットするイベントオブジェクトへのハンドルです。このハンドルは CreateEvent 関数または OpenEvent 関数が返します。
pdwCookie	DWORD*	out	キー値へのポインターです。アプリケーションはこの値を IDXGIAdapter3::UnregisterHardwareContentProtectionTeardownStatus メソッドに渡すことで、hEvent で指定した通知イベントの登録を解除できます。

戻り値

Type: HRESULT

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

解説(Remarks)

ID3D11VideoDevice::GetContentProtectionCaps() を呼び出して D3D11_CONTENT_PROTECTION_CAPS_HARDWARE_TEARDOWN 機能の有無を確認することで、ハードウェアが自動ティアダウン機構を備えているかどうかを判断できます。

イベントがシグナル状態になった後、アプリケーションは ID3D11VideoContext1::CheckCryptoSessionStatus を呼び出して、特定の ID3D11CryptoSession インターフェースに対するハードウェアティアダウンの影響を判断できます。

vtbl 13 void UnregisterHardwareContentProtectionTeardownStatus(DWORD dwCookie)

イベントの登録を解除し、ハードウェアコンテンツ保護のティアダウンイベントの通知を受け取らないようにします。

dwCookie

DWORD

登録を解除するウィンドウまたはイベントのキー値です。この値は IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent メソッドが返します。

vtbl 14 HRESULT QueryVideoMemoryInfo(DWORD NodeIndex, DXGI_MEMORY_SEGMENT_GROUP MemorySegmentGroup, DXGI_QUERY_VIDEO_MEMORY_INFO* pVideoMemoryInfo)

このメソッドは、現在のバジェットとプロセスの使用量をプロセスに通知します。

NodeIndex	DWORD	in	ビデオメモリ情報を照会する対象となるデバイスの物理アダプターを指定します。単一 GPU で動作する場合は、これを 0 に設定します。複数の GPU ノードがある場合は、ビデオメモリ情報を照会する対象となるノード(デバイスの物理アダプター)のインデックスを設定します。マルチアダプターシステムを参照してください。
MemorySegmentGroup	DXGI_MEMORY_SEGMENT_GROUP	in	グループをローカルまたは非ローカルとして識別する DXGI_MEMORY_SEGMENT_GROUP を指定します。
pVideoMemoryInfo	DXGI_QUERY_VIDEO_MEMORY_INFO*	out	現在の値を DXGI_QUERY_VIDEO_MEMORY_INFO 構造体に設定します。

戻り値

Type: HRESULT

成功した場合は S_OK を返します。それ以外の場合はエラーコードを返します。エラーコードの一覧については、DXGI_ERROR を参照してください。

解説(Remarks)

アプリケーションは物理メモリの使用量を明示的に管理し、アプリケーションプロセスに割り当てられたバジェットの範囲内に使用量を収める必要があります。割り当てられたバジェットの範囲内に使用量を収められないプロセスは、他のプロセスを実行できるように断続的に凍結されページアウトされるため、スタッタリングが発生する可能性があります。

vtbl 15 HRESULT SetVideoMemoryReservation(DWORD NodeIndex, DXGI_MEMORY_SEGMENT_GROUP MemorySegmentGroup, ULONGLONG Reservation)

このメソッドは、アプリケーションに最低限必要な物理メモリ量を OS に通知します。

NodeIndex	DWORD	in	ビデオメモリ情報を設定する対象となるデバイスの物理アダプターを指定します。単一 GPU で動作する場合は、これを 0 に設定します。複数の GPU ノードがある場合は、ビデオメモリ情報を設定する対象となるノード(デバイスの物理アダプター)のインデックスを設定します。マルチアダプターシステムを参照してください。
MemorySegmentGroup	DXGI_MEMORY_SEGMENT_GROUP	in	グループをローカルまたは非ローカルとして識別する DXGI_MEMORY_SEGMENT_GROUP を指定します。
Reservation	ULONGLONG	in	最低限必要な物理メモリ量をバイト単位で設定する UINT64 を指定します。

戻り値

Type: HRESULT

成功した場合は S_OK を返します。それ以外の場合はエラーコードを返します。エラーコードの一覧については、DXGI_ERROR を参照してください。

解説(Remarks)

アプリケーションは、これだけは欠かせないという物理メモリ量を示すために、ビデオメモリの予約を設定することが推奨されます。この値は、大きなメモリ負荷が発生した状況で OS がその影響を迅速に最小化するのに役立ちます。

vtbl 16 HRESULT RegisterVideoMemoryBudgetChangeNotificationEvent(HANDLE hEvent, DWORD* pdwCookie)

このメソッドは、CPU 同期オブジェクトとバジェット変更イベントとの間の関連付けを確立します。

hEvent	HANDLE	in	メモリバジェットが変化したときにオペレーティングシステムがセットするイベントオブジェクトへのハンドルです。このハンドルは CreateEvent 関数および OpenEvent 関数が返します。
pdwCookie	DWORD*	out	キー値へのポインターです。この値を IDXGIAdapter3::UnregisterVideoMemoryBudgetChangeNotification メソッドに渡すことで、hEvent で指定した通知イベントの登録を解除できます。

戻り値

Type: HRESULT

このメソッドは HRESULT の成功コードまたはエラーコードを返します。

解説(Remarks)

アプリケーションは、定期的に QueryVideoMemoryInfo を呼び出す代わりに、CPU 同期オブジェクトを使用することで、バジェット変更が発生したときにスレッドを効率的に起こすことができます。

vtbl 17 void UnregisterVideoMemoryBudgetChangeNotification(DWORD dwCookie)

このメソッドは、バジェット変更が発生するたびに CPU 同期オブジェクトへ通知するのを停止します。アプリケーションは、定期的に情報をポーリングする方式に戻すことができます。

dwCookie

DWORD

登録を解除するウィンドウまたはイベントのキー値です。この値は IDXGIAdapter3::RegisterHardwareContentProtectionTeardownStatusEvent メソッドが返します。

解説(Remarks)

アプリケーションは、定期的に情報をポーリングする方式に戻すことができます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IDXGIAdapter3 "{645967A4-1392-4310-A798-8053CE3E93FD}"
#usecom global IDXGIAdapter3 IID_IDXGIAdapter3 "{}"
#comfunc global IDXGIAdapter3_RegisterHardwareContentProtectionTeardownStatusEvent  12 sptr,var
#comfunc global IDXGIAdapter3_UnregisterHardwareContentProtectionTeardownStatus     13 int
#comfunc global IDXGIAdapter3_QueryVideoMemoryInfo                                  14 int,int,var
#comfunc global IDXGIAdapter3_SetVideoMemoryReservation                             15 int,int,int64
#comfunc global IDXGIAdapter3_RegisterVideoMemoryBudgetChangeNotificationEvent      16 sptr,var
#comfunc global IDXGIAdapter3_UnregisterVideoMemoryBudgetChangeNotification         17 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_IDXGIAdapter3 "{645967A4-1392-4310-A798-8053CE3E93FD}"
#usecom global IDXGIAdapter3 IID_IDXGIAdapter3 "{}"
#comfunc global IDXGIAdapter3_RegisterHardwareContentProtectionTeardownStatusEvent  12 sptr,sptr
#comfunc global IDXGIAdapter3_UnregisterHardwareContentProtectionTeardownStatus     13 int
#comfunc global IDXGIAdapter3_QueryVideoMemoryInfo                                  14 int,int,sptr
#comfunc global IDXGIAdapter3_SetVideoMemoryReservation                             15 int,int,int64
#comfunc global IDXGIAdapter3_RegisterVideoMemoryBudgetChangeNotificationEvent      16 sptr,sptr
#comfunc global IDXGIAdapter3_UnregisterVideoMemoryBudgetChangeNotification         17 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。