特定の GPU イベントでキャプチャされた D3D12 テクスチャ リソースの未加工バイトを読み取ります。
構文
HRESULT GetTextureBytesFromResource(
IPixD3D12Resource * resource,
const PIX_EVENT_INFO * eventInfo,
const PIX_GET_TEXTURE_BYTES_PARAMETERS * getTextureBytesParameters,
REFIID riid,
void ** outputBytes);
パラメーター
resource [in]
この分析インスタンスによって所有される D3D12 テクスチャ リソース。
eventInfo [in]
キャプチャのタイムライン内でバイトを読み取るポイントを特定する GPU イベント。
getTextureBytesParameters [in]
オプションの読み取りパラメーター。 null の場合、最初に再生をリセットせずにイベントの後に読み取り、すべてのサブリソースを要求します。
riid [in]
返されるオブジェクトのインターフェイス IID。 Expected: すべてのサブリソースを要求するときの IPixTexture 。 特定のサブリソースを要求するときの IPixTextureSubresource。
outputBytes [out]
要求されたテクスチャ データとハンドを含む新しく作成された IPixTexture または IPixTextureSubresource を受け取り、呼び出し元にハンドを提供します。
戻り値
成功のS_OK。 resource または eventInfo が null の場合は E_POINTER。 riid が予期されたインターフェイスではない場合にE_NOINTERFACEします。 リソース、イベント、またはサブリソースの選択が無効な場合はE_INVALIDARG。 テクスチャの形式またはサンプリング モードがまだ読み戻しでサポートされていない場合はE_NOTIMPLします。 分析が実行されていない場合はE_PIX_ANALYSIS_NOT_RUNNINGします。
解説
警告
リソースは、この分析インスタンス用に PIX で作成されたリソースである必要があります。PIX 以外のリソースを渡すと、E_INVALIDARG が返されます。