METODE IDXGIObject::SetPrivateData (dxgi.h)

Mengatur data yang ditentukan aplikasi ke objek dan mengaitkan data tersebut dengan GUID.

Sintaks

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

Parameter

[in] Name

Jenis: REFGUID

GUID yang mengidentifikasi data. Gunakan GUID ini dalam panggilan ke GetPrivateData untuk mendapatkan data.

DataSize

Jenis: UINT

Ukuran data objek.

[in] pData

Jenis: const void*

Penunjuk ke data objek.

Menampilkan nilai

Jenis: HRESULT

Mengembalikan salah satu nilai DXGI_ERROR .

Keterangan

SetPrivateData membuat salinan data yang ditentukan dan menyimpannya dengan objek .

Data privat yang disimpan SetPrivateData di objek menempati ruang penyimpanan yang sama dengan data privat yang disimpan oleh objek Direct3D terkait (misalnya, oleh perangkat Microsoft Direct3D 11 melalui ID3D11Device::SetPrivateData atau oleh perangkat turunan Direct3D 11 melalui ID3D11DeviceChild::SetPrivateData).

Lapisan debug melaporkan kebocoran memori dengan menghasilkan daftar penunjuk antarmuka objek bersama dengan nama yang mudah diingat. Nama bersahabat default adalah "<tidak bernama>". Anda dapat mengatur nama yang mudah diingat sehingga Anda dapat menentukan apakah penunjuk antarmuka objek yang sesuai menyebabkan kebocoran. Untuk mengatur nama yang mudah diingat, gunakan metode SetPrivateData dan GUID data privat terkenal (WKPDID_D3DDebugObjectName) yang ada di D3Dcommon.h. Misalnya, untuk memberi pContext nama yang mudah diingat dari Nama saya, gunakan kode berikut:

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

Anda dapat menggunakan WKPDID_D3DDebugObjectName untuk melacak kebocoran memori dan memahami karakteristik performa aplikasi Anda. Informasi ini tercermin dalam output lapisan debug yang terkait dengan kebocoran memori (ID3D11Debug::ReportLiveDeviceObjects) dan dengan pelacakan peristiwa untuk peristiwa Windows yang telah kami tambahkan ke Windows 8.

Persyaratan

Target Platform	Windows
Header	dxgi.h
Pustaka	DXGI.lib

Lihat juga

Antarmuka DXGI

IDXGIObject