IDXGIObject_SetPrivateData

アプリケーション定義データをオブジェクトに設定し、そのデータを GUID に関連付ける。

IDXGIObject_SetPrivateData this, Name, DataSize, pData

this : [comobj] IDXGIObject インターフェースの COM オブジェクト変数
Name : [var] 型: REFGUID データを識別する GUID。この GUID を GetPrivateData の呼び出しで使用してデータを取得する。
DataSize : [int] 型: UINT オブジェクトデータのサイズ。
pData : [intptr] 型: const void* オブジェクトデータへのポインタ。

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

解説

アプリケーション定義データをオブジェクトに設定し、そのデータを GUID に関連付ける。

[戻り値]
型: HRESULT DXGI_ERROR の値のいずれかを返す。

[備考]
SetPrivateData は指定されたデータのコピーを作成し、オブジェクトとともに格納する。SetPrivateData
がオブジェクトに格納するプライベートデータは、関連付けられた Direct3D オブジェクトが格納するプライベートデータ (例えば
Microsoft Direct3D 11 デバイスが ID3D11Device::SetPrivateData で、または
Direct3D 11 子デバイスが ID3D11DeviceChild::SetPrivateData で格納するもの)
と同じ記憶領域を占有する。デバッグレイヤーはオブジェクトインターフェースポインタ一覧をフレンドリ名付きで出力してメモリリークを報告する。既定のフレンドリ名は
"<unnamed>"
である。どのオブジェクトインターフェースポインタがリークの原因になったかを特定できるようにフレンドリ名を設定できる。フレンドリ名を設定するには、SetPrivateData
メソッドと D3Dcommon.h にある既知のプライベートデータ GUID (WKPDID_D3DDebugObjectName)
を使用する。たとえば pContext にフレンドリ名 My name を付与するには次のコードを使用する。
（以下省略）

情報