IPixStateObject::GetDesc メソッド

このオブジェクトを生成するために使用される状態オブジェクト記述の PIX 表現を取得します。

構文

HRESULT GetDesc(
    UINT32 index,
    const PIX_STATE_OBJECT_DESC ** stateObjectDesc);

パラメーター

index [in]

範囲 [0, GetDescCount()) 内の 0 から始まる説明インデックス。

stateObjectDesc [out]

要求された状態オブジェクトの説明へのポインター。

戻り値

成功時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 を呼び出します。

関連項目