特定の GPU イベントでバッファーに基づくリソース ビューの未加工バイトを読み取ります。
構文
HRESULT GetBufferBytesFromResourceView(
IPixResourceView * resourceView,
const PIX_EVENT_INFO * eventInfo,
const PIX_GET_BUFFER_BYTES_PARAMETERS * getBufferBytesParameters,
REFIID riid,
void ** outputBytes);
パラメーター
resourceView [in]
返すバイトを記述するリソース ビュー。 キャプチャ ドキュメントからリソース ビューを取得するには: GetProgramState(event) を呼び出して、選択したイベントの IPixProgramState を取得し、 次に IPixGenericPipeline の GetGpuProgram()、IPixResourceViewsAtEvent の GetResourceViews()、 IPixResourceView の GetView(index) を取得します。
eventInfo [in]
キャプチャのタイムライン内でバイトを読み取るポイントを特定する GPU イベント。 GetQueues および IPixGpuCaptureQueueInfo::GetEvent を使用して、キャプチャ ドキュメントのキューからイベントを取得します。 これは、リソース ビューのフェッチに使用されるタイムライン内の同じポイントを識別します。
getBufferBytesParameters [in]
読み取りパラメーター (イベント前とイベント後のバイト数、および強制的に再読み取りを行うかどうか)。 省略可能;null の場合、既定値が使用されます (再読み取りを強制せずに、イベントの直後のバイト数)。
riid [in]
返されるオブジェクトのインターフェイス IID。 予期: IPixBlob
outputBytes [out]
このメソッドが割り当てて呼び出し元に渡す新しく作成された IPixBlob を受け取ります。 BLOB は、リソースへの完全なビュー ウィンドウをカバーします (ビュー オフセット + ビュー サイズ)。
戻り値
成功のS_OK。 resourceView または eventInfo が null の場合は E_POINTER。 riid が IID_IPixBlob でない場合はE_NOINTERFACEします。 不適格なビューの種類、呼び出し元によって実装されたビューまたは外部ドキュメントのビュー、不明なイベント、または親コマンド リストがないイベントのE_INVALIDARG。 分析が現在実行されていない場合はE_PIX_ANALYSIS_NOT_RUNNINGします。 E_PIX_BUFFER_VIEW_SIZEINBYTES_IS_ZERO resourceView が頂点バッファー、インデックス バッファー、ストリーム出力、または定数バッファー ビューであり、SizeInBytes がゼロであり、返すバイトを指定しません。
解説
警告
resourceView はバッファーが有効なビューである必要があります。バッファー以外のビューを渡すと、E_INVALIDARG が返されます。
警告
resourceView は、この分析インスタンス用に PIX で作成されたビューである必要があります。PIX 以外のビューを渡すと、E_INVALIDARG が返されます。