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 通常會是應用程式定義的。
偵 錯層 會藉由輸出物件介面指標清單及其易記名稱來報告記憶體流失。 預設易記名稱為 「<未命名>」。 您可以設定易記名稱,以便判斷對應的物件介面指標是否造成流失。 若要設定易記名稱,請使用 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 );
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | d3d11.h |
程式庫 | D3D11.lib |