取得用於產生此物件之狀態物件描述的 PIX 表示法。
語法
HRESULT GetDesc(
UINT32 index,
const PIX_STATE_OBJECT_DESC ** stateObjectDesc);
參數
index [在]
範圍 [0， GetDescCount () ) 中從零開始的描述索引。
stateObjectDesc [出]
指向要求狀態物件描述的指標。
傳回
成功時S_OK，如果索引超出有效範圍，則E_INVALIDARG。
註解
警告
這是 PIX API 表示法，不是與 D3D12 相容的描述。 請勿直接將它傳遞給預期 D3D 介面指標的 D3D12 或 D3DX12 協助程式。 首先，將每個 PIX 特定承載取代為其 D3D12 對等項，並提供為目標裝置建立的 D3D12 物件。
針對D3D12_STATE_SUBOBJECT_TYPE_GLOBAL_ROOT_SIGNATURE和D3D12_STATE_SUBOBJECT_TYPE_LOCAL_ROOT_SIGNATURE，pDesc 會指向 PIX_STATE_OBJECT_ROOT_SIGNATURE_DESC。 針對D3D12_STATE_SUBOBJECT_TYPE_EXISTING_COLLECTION，pDesc 指向 PIX_STATE_OBJECT_EXISTING_COLLECTION_DESC。 所有其他傳回的子物件都會使用其 D3D12 表示法。 如果 PIX 不支援公開擷取的子物件類型，該子物件會保留在其原始位置，並將 pDesc 設定為 nullptr。 子物件之間的參照有效。 傳回的描述和所有參考的資料在此介面的存留期內保持有效。 子物件描述中包含的 PIX 介面指標在此介面處於作用中時保持有效。 不會將任何參考內容轉送到呼叫者。 如果參考的物件之後必須保持有效，請在釋放此介面之前呼叫 AddRef。