ID3D11Device::SetPrivateData メソッド (d3d11.h)

データをデバイスに設定し、そのデータを guid に関連付けます。

構文

HRESULT SetPrivateData(
  [in]           REFGUID    guid,
  [in]           UINT       DataSize,
  [in, optional] const void *pData
);

パラメーター

[in] guid

型: REFGUID

データに関連付けられている Guid。

[in] DataSize

型: UINT

データのサイズ。

[in, optional] pData

型: const void*

このデバイスに格納するデータへのポインター。 pData が NULL の場合、DataSize も 0 である必要があり、guid に以前に関連付けられたデータはすべて破棄されます。

戻り値

型: HRESULT

このメソッドは、次のいずれかの Direct3D 11 リターン コードを返します。

注釈

このメソッドを使用してデバイスに格納されているデータは 、ID3D11Device::GetPrivateData を使用して取得できます。

このメソッドで設定されたデータと guid は、通常、アプリケーションで定義されます。

デバッグ レイヤーは、オブジェクト インターフェイス ポインターの一覧とそのフレンドリ名を出力することで、メモリ リークを報告します。 既定のフレンドリ名は "<unnamed>" です。 フレンドリ名を設定して、対応するオブジェクト インターフェイス ポインターによってリークが発生したかどうかを判断できます。 フレンドリ名を設定するには、 SetPrivateData メソッドと D3Dcommon.h にある WKPDID_D3DDebugObjectName GUID を使用します。 たとえば、pContext に [マイ名] というフレンドリ名を付ける場合は、次のコードを使用します。

static const char c_szName[] = "My name";
hr = pContext->SetPrivateData( WKPDID_D3DDebugObjectName, sizeof( c_szName ) - 1, c_szName );

要件

こちらもご覧ください

ID3D11Device