Device Removed Extended Data (DRED) を取得します。 D3D12_DRED_AUTO_BREADCRUMBS_OUTPUT1::p HeadAutoBreadcrumbNode は、デバイス エラー時に DRED 自動ブレッドクラムが有効になっている場合、D3D12_AUTO_BREADCRUMB_NODE1以前の構造体を指します。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandListDebugNameA は ID3D12GraphicsCommandList::SetPrivateData によって設定された文字列をポイントします。呼び出された場合は WKPDID_D3DDebugObjectName、それ以外の場合は nullptr。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandListDebugNameW は ID3D12GraphicsCommandList::SetPrivateData によって設定された文字列をポイントします。呼び出された場合は WKPDID_D3DDebugObjectNameW、それ以外の場合は nullptr。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandQueueDebugNameA は、ID3D12CommandQueue::SetPrivateData によって設定された文字列をポイントします。呼び出された場合は WKPDID_D3DDebugObjectName、それ以外の場合は nullptr。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandQueueDebugNameW は、ID3D12CommandQueue::SetPrivateData によって設定された文字列を WKPDID_D3DDebugObjectNameW でポイントします。それ以外の場合は nullptr。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandList は、デバイス エラー発生時の未処理のコマンド リストのアドレスであり、事後デバッグ中の逆参照への有効なポインターではありません。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandQueue は未処理のコマンド キューのアドレスであり、事後デバッグ中の逆参照への有効なポインターではありません。 D3D12_AUTO_BREADCRUMB_NODE1::p LastBreadcrumbValue は、デバイス エラー時に完了した pCommandHistory 階層リンク操作の数をポイントし、操作が完了していない場合は nullptr を指します。 D3D12_AUTO_BREADCRUMB_NODE1::p CommandHistory は、関連付けられたコマンド リストに記録されたすべてのレンダリング/計算操作を表すD3D12_AUTO_BREADCRUMB_OP値の配列を指します。 D3D12_AUTO_BREADCRUMB_NODE1::p Next は、リスト内の次の自動階層リンク ノードを表すD3D12_AUTO_BREADCRUMB_NODE1を指し、これが最後のノードの場合は nullptr を指します。 D3D12_AUTO_BREADCRUMB_NODE1::p BreadcrumbContexts は、PIX マーカーを表すD3D12_DRED_BREADCRUMB_CONTEXTの配列を指します。または、PIX マーカーがない場合は nullptr を指します。 デバイス エラーが GPU ページ フォールトによって発生し、デバイス エラー時に DRED ページ フォールトレポートが有効になっている場合、D3D12_DRED_PAGE_FAULT_OUTPUT2 および古いバージョンの構造体のメンバーは有効です。 D3D12_DRED_PAGE_FAULT_OUTPUT2::p HeadExistingAllocationNode はD3D12_DRED_ALLOCATION_NODE障害のある VA (PageFaultVA) と一致する仮想アドレス (VA) 範囲を持つアクティブな割り当てランタイム オブジェクトの割り当てノードのリンク リストを表すオブジェクトを指し、リストが空の場合は nullptr を指定します。 D3D12_DRED_PAGE_FAULT_OUTPUT2::p HeadRecentFreedAllocationNode はD3D12_DRED_ALLOCATION_NODE最近解放されたランタイム オブジェクトの割り当てノードのリンク リストの先頭を表すオブジェクトを指し、仮想アドレス (VA) 範囲が障害のある VA (PageFaultVA) と一致するか、リストが空の場合は nullptr を持ちます。 D3D12_DRED_ALLOCATION_NODE1::ObjectNameA は、割り当てられたランタイム オブジェクトの ASCII デバッグ名を指し、それ以外の場合は nullptr D3D12_DRED_ALLOCATION_NODE1::ObjectNameW は割り当てられたランタイム オブジェクトの Unicode デバッグ名を指し、それ以外の場合は D3D12_DRED_ALLOCATION_NODE1::p Next は、リスト内の次の割り当てノードを表す D3D12_DRED_ALLOCATION_NODE1 を指し、これが最後のノードの場合は nullptr を指します。 D3D12_DRED_ALLOCATION_NODE1::p Object は、デバイス エラー発生時の割り当てられたランタイム オブジェクトのアドレスであり、事後デバッグ中の逆参照への有効なポインターではありません。
構文
D3D12_VERSIONED_DEVICE_REMOVED_EXTENDED_DATA GetDeviceRemovedExtendedData();
パラメーター
このメソッドにはパラメーターはありません。
戻り値
デバイスによって拡張データ (DRED) が削除されました。
解説
注
返された構造体から到達可能なすべてのポインターは PIX によって所有され、この IPixDxDumpFileDocument オブジェクトの有効期間中有効です。解放しないでください。 デバイス エラー時にキャプチャされたアプリケーション/GPU アドレス (pCommandList、pCommandQueue、pObject など) を保持するポインターは逆参照しないでください。