METODE ID3D11Device::SetPrivateData (d3d11.h)

Atur data ke perangkat dan kaitkan data tersebut dengan panduan.

Sintaks

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

Parameter

[in] guid

Jenis: REFGUID

Guid yang terkait dengan data.

[in] DataSize

Jenis: UINT

Ukuran data.

[in, optional] pData

Jenis: const void*

Arahkan ke data yang akan disimpan dengan perangkat ini. Jika pData NULL, DataSize juga harus 0, dan data apa pun yang sebelumnya terkait dengan guid akan dihancurkan.

Nilai kembali

Jenis: HRESULT

Metode ini mengembalikan salah satu Kode Pengembalian Direct3D 11 berikut.

Keterangan

Data yang disimpan di perangkat dengan metode ini dapat diambil dengan ID3D11Device::GetPrivateData.

Himpunan data dan guid dengan metode ini biasanya akan ditentukan aplikasi.

Lapisan debug melaporkan kebocoran memori dengan mengeluarkan daftar penunjuk antarmuka objek bersama dengan nama mereka yang mudah diingat. Nama akrab 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 WKPDID_D3DDebugObjectName yang ada di D3Dcommon.h. Misalnya, untuk memberi pContext nama nama saya yang mudah diingat, gunakan kode berikut:


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

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header d3d11.h
Pustaka D3D11.lib

Lihat juga

ID3D11Device