跳轉到主要內容
將名稱與裝置物件建立關聯。 此名稱用於偵錯診斷和工具。

語法

參數

Name [in]
類型:LPCWSTR
以 NULL 結尾的 UNICODE 字串,包含要與裝置物件建立關聯的名稱。

傳回值

類型:HRESULT 此方法會傳回其中一個 Direct3D 12 傳回碼。

備註

此方法接受 UNICODE 名稱。 請注意,這只是搭配 WKPDID_D3DDebugObjectNameW 使用 ID3D12Object::SetPrivateData 的便利包裝函式。 因此,以 SetName 設定的名稱可以使用相同的 GUID 透過 ID3D12Object::GetPrivateData 擷取。 此外,D3D12 也支援以窄字串作為名稱,改為直接使用 WKPDID_D3DDebugObjectName GUID 即可。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台: XBOX Series 主機和 XBOX One 系列

另請參閱

Direct3D 12 程式設計環境設定 ID3D12Object
最後修改於 2026年10月6日