ホーム › Media.MediaFoundation › ID3D12VideoProcessCommandList

ID3D12VideoProcessCommandList

COM

📘 Microsoft Learn (日本語) · English

IIDaeb2543a-167f-4682-acc8-d159ed4a6209継承元ID3D12CommandList自前メソッド開始 vtbl9

公式ドキュメント

ビデオ処理のためのグラフィックスコマンドのリストをカプセル化します。(ID3D12VideoProcessCommandList)

メソッド 14

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 9 HRESULT Close()

コマンドリストへの記録が完了したことを示します。(ID3D12VideoProcessCommandList::Close)

戻り値

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかの値を返します:

コマンドリストがすでに閉じられている場合、またはコマンドリストの記録中に無効な API が呼び出された場合は E_FAIL。
記録中にオペレーティングシステムのメモリが不足した場合は E_OUTOFMEMORY。
記録中にコマンドリスト API に無効な引数が渡された場合は E_INVALIDARG。

その他の返される可能性のある値については、Direct3D 12 のリターンコードを参照してください。

解説(Remarks)

ランタイムは、コマンドリストが以前に閉じられていないことを検証します。記録中にエラーが発生した場合は、そのエラーコードがここで返されます。この場合、ランタイムは close デバイスドライバーインターフェイス (DDI) を呼び出しません。

コマンドリストの作成例については、ID3D12GraphicsCommandList::Close メソッドを参照してください。

vtbl 10 HRESULT Reset(ID3D12CommandAllocator* pAllocator)

新しいコマンドリストが作成されたばかりであるかのように、コマンドリストを初期状態にリセットします。(ID3D12VideoProcessCommandList::Reset)

pAllocator

ID3D12CommandAllocator*

デバイスがコマンドリストを作成する元となる ID3D12CommandAllocator オブジェクトへのポインター。

戻り値

型: HRESULT

成功した場合は S_OK を返します。それ以外の場合は、次のいずれかの値を返します:

Reset の呼び出し時にコマンドリストが「closed」状態でなかった場合、またはデバイスあたりの上限を超過する場合は E_FAIL。
オペレーティングシステムのメモリが不足した場合は E_OUTOFMEMORY。
アロケーターが現在「recording」状態の別のコマンドリストで使用されている場合、または指定されたアロケーターが誤った型で作成されていた場合は E_INVALIDARG。

その他の返される可能性のある値については、Direct3D 12 のリターンコードを参照してください。

解説(Remarks)

このメソッドの使用に関する追加情報および例については、ID3D12GraphicsCommandList::Reset メソッドを参照してください。

vtbl 11 void ClearState()

ダイレクトコマンドリストの状態を、コマンドリストが作成されたときの状態に戻します。(ID3D12VideoProcessCommandList::ClearState)

vtbl 12 void ResourceBarrier(DWORD NumBarriers, D3D12_RESOURCE_BARRIER* pBarriers)

リソースへの複数のアクセスを同期する必要があることをドライバーに通知します。(ID3D12VideoProcessCommandList::ResourceBarrier)

NumBarriers	DWORD	in	送信されるバリア記述子の数。
pBarriers	D3D12_RESOURCE_BARRIER*	in	バリア記述子の配列へのポインター。

vtbl 13 void DiscardResource(ID3D12Resource* pResource, D3D12_DISCARD_REGION* pRegion)

リソースの現在の内容を破棄できることを示します。

pResource	ID3D12Resource*	in	破棄するリソースの ID3D12Resource インターフェイスへのポインター。
pRegion	D3D12_DISCARD_REGION*	inoptional	リソース破棄操作の詳細を記述する D3D12_DISCARD_REGION 構造体へのポインター。

vtbl 14 void BeginQuery(ID3D12QueryHeap* pQueryHeap, D3D12_QUERY_TYPE Type, DWORD Index)

クエリの実行を開始します。(ID3D12VideoProcessCommandList::BeginQuery)

pQueryHeap	ID3D12QueryHeap*	in	このクエリのストレージを指定する ID3D12QueryHeap へのポインター。
Type	D3D12_QUERY_TYPE	in	クエリの種類を指定する D3D12_QUERY_TYPE 列挙体のメンバー。
Index	DWORD	in	クエリヒープ内のクエリのインデックス。

解説(Remarks)

一部のクエリは BeginQuery を使用せず、EndQuery のみを持ちます。適切な使用方法を判断するには、D3D12_QUERY_TYPE の各クエリの種類を参照してください。

vtbl 15 void EndQuery(ID3D12QueryHeap* pQueryHeap, D3D12_QUERY_TYPE Type, DWORD Index)

クエリを終了します。(ID3D12VideoProcessCommandList::EndQuery)

pQueryHeap	ID3D12QueryHeap*	in	このクエリのストレージを指定する ID3D12QueryHeap へのポインター。
Type	D3D12_QUERY_TYPE	in	クエリの種類を指定する D3D12_QUERY_TYPE 列挙体のメンバー。
Index	DWORD	in	クエリヒープ内のクエリのインデックス。

vtbl 16 void ResolveQueryData(ID3D12QueryHeap* pQueryHeap, D3D12_QUERY_TYPE Type, DWORD StartIndex, DWORD NumQueries, ID3D12Resource* pDestinationBuffer, ULONGLONG AlignedDestinationBufferOffset)

クエリからデータを抽出します。(ID3D12VideoProcessCommandList::ResolveQueryData)

pQueryHeap	ID3D12QueryHeap*	in	解決するクエリを格納するストレージを指定する ID3D12QueryHeap へのポインター。
Type	D3D12_QUERY_TYPE	in	クエリの種類を指定する D3D12_QUERY_TYPE 列挙体のメンバー。
StartIndex	DWORD	in	解決する最初のクエリのインデックス。
NumQueries	DWORD	in	解決するクエリの数。
pDestinationBuffer	ID3D12Resource*	in	宛先バッファーを表す ID3D12Resource へのポインター。このリソースは D3D12_RESOURCE_STATE_COPY_DEST 状態でなければなりません。
AlignedDestinationBufferOffset	ULONGLONG	in	宛先バッファーへのアラインメントオフセット。これは 8 バイトの倍数でなければなりません。

vtbl 17 void SetPredication(ID3D12Resource* pBuffer, ULONGLONG AlignedBufferOffset, D3D12_PREDICATION_OP Operation)

述語値が指定された操作に合格した場合に、後続のコマンドを実行しないように指定します。(ID3D12VideoProcessCommandList::SetPredication)

pBuffer	ID3D12Resource*	inoptional	64 ビットの述語値を読み取る元となるバッファーを表す ID3D12Resource へのポインター。
AlignedBufferOffset	ULONGLONG	in	UINT64 にアラインメントされたバッファーオフセット。
Operation	D3D12_PREDICATION_OP	in	述語操作を指定する D3D12_PREDICATION_OP 列挙体のメンバー。

vtbl 18 void SetMarker(DWORD Metadata, void* pData, DWORD Size)

内部使用専用です。直接呼び出すことを意図していません。

Metadata	DWORD	in	内部使用。
pData	void*	inoptional	内部使用。
Size	DWORD	in	内部使用。

vtbl 19 void BeginEvent(DWORD Metadata, void* pData, DWORD Size)

内部使用専用です。直接呼び出すことを意図していません。(ID3D12VideoProcessCommandList::BeginEvent)

Metadata	DWORD	in	内部使用。
pData	void*	inoptional	内部使用。
Size	DWORD	in	内部使用。

vtbl 20 void EndEvent()

内部使用専用です。直接呼び出すことを意図していません。(ID3D12VideoProcessCommandList::EndEvent)

vtbl 21 void ProcessFrames(ID3D12VideoProcessor* pVideoProcessor, D3D12_VIDEO_PROCESS_OUTPUT_STREAM_ARGUMENTS* pOutputArguments, DWORD NumInputStreams, D3D12_VIDEO_PROCESS_INPUT_STREAM_ARGUMENTS* pInputArguments)

1 つ以上の入力サンプルを操作し、その結果を出力サーフェスに書き込むビデオ処理操作をコマンドリストに記録します。(ID3D12VideoProcessCommandList::ProcessFrames)

pVideoProcessor	ID3D12VideoProcessor*	in	ビデオプロセッサーのインスタンスを表す ID3D12VideoProcessor インターフェイスへのポインター。
pOutputArguments	D3D12_VIDEO_PROCESS_OUTPUT_STREAM_ARGUMENTS*	in	出力サーフェスと出力引数を指定する D3D12_VIDEO_PROCESS_OUTPUT_STREAM_ARGUMENTS 構造体。
NumInputStreams	DWORD	in	入力ストリームの数。
pInputArguments	D3D12_VIDEO_PROCESS_INPUT_STREAM_ARGUMENTS*	in	入力パラメーターを指定する D3D12_VIDEO_PROCESS_INPUT_STREAM_ARGUMENTS 構造体の配列へのポインター。

解説(Remarks)

このバージョンのメソッドでは、D3D12_VIDEO_FIELD_TYPE を変更することはできません。混在コンテンツを扱う場合は、代わりに ID3D12VideoProcessCommandList::ProcessFrames1 を使用してください。このメソッドでは、呼び出しごとにフィールドタイプを指定できます。

vtbl 22 void WriteBufferImmediate(DWORD Count, D3D12_WRITEBUFFERIMMEDIATE_PARAMETER* pParams, D3D12_WRITEBUFFERIMMEDIATE_MODE* pModes)

多数の 32 ビットの即値を、コマンドストリームから直接、指定されたバッファーの場所に書き込みます。(ID3D12VideoProcessCommandList::WriteBufferImmediate)

Count	DWORD	in	pParams および pModes 配列内の要素の数。
pParams	D3D12_WRITEBUFFERIMMEDIATE_PARAMETER*	in	サイズ Count の D3D12_WRITEBUFFERIMMEDIATE_PARAMETER 構造体の配列のアドレス。
pModes	D3D12_WRITEBUFFERIMMEDIATE_MODE*	inoptional	サイズ Count の D3D12_WRITEBUFFERIMMEDIATE_MODE 構造体の配列のアドレス。既定値は null です。null を渡すと、システムはすべての即値を D3D12_WRITEBUFFERIMMEDIATE_MODE_DEFAULT を使用して書き込みます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ID3D12VideoProcessCommandList "{AEB2543A-167F-4682-ACC8-D159ED4A6209}"
#usecom global ID3D12VideoProcessCommandList IID_ID3D12VideoProcessCommandList "{}"
#comfunc global ID3D12VideoProcessCommandList_Close                 9
#comfunc global ID3D12VideoProcessCommandList_Reset                 10 sptr
#comfunc global ID3D12VideoProcessCommandList_ClearState            11
#comfunc global ID3D12VideoProcessCommandList_ResourceBarrier       12 int,var
#comfunc global ID3D12VideoProcessCommandList_DiscardResource       13 sptr,var
#comfunc global ID3D12VideoProcessCommandList_BeginQuery            14 sptr,int,int
#comfunc global ID3D12VideoProcessCommandList_EndQuery              15 sptr,int,int
#comfunc global ID3D12VideoProcessCommandList_ResolveQueryData      16 sptr,int,int,int,sptr,int64
#comfunc global ID3D12VideoProcessCommandList_SetPredication        17 sptr,int64,int
#comfunc global ID3D12VideoProcessCommandList_SetMarker             18 int,sptr,int
#comfunc global ID3D12VideoProcessCommandList_BeginEvent            19 int,sptr,int
#comfunc global ID3D12VideoProcessCommandList_EndEvent              20
#comfunc global ID3D12VideoProcessCommandList_ProcessFrames         21 sptr,var,int,var
#comfunc global ID3D12VideoProcessCommandList_WriteBufferImmediate  22 int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ID3D12VideoProcessCommandList "{AEB2543A-167F-4682-ACC8-D159ED4A6209}"
#usecom global ID3D12VideoProcessCommandList IID_ID3D12VideoProcessCommandList "{}"
#comfunc global ID3D12VideoProcessCommandList_Close                 9
#comfunc global ID3D12VideoProcessCommandList_Reset                 10 sptr
#comfunc global ID3D12VideoProcessCommandList_ClearState            11
#comfunc global ID3D12VideoProcessCommandList_ResourceBarrier       12 int,sptr
#comfunc global ID3D12VideoProcessCommandList_DiscardResource       13 sptr,sptr
#comfunc global ID3D12VideoProcessCommandList_BeginQuery            14 sptr,int,int
#comfunc global ID3D12VideoProcessCommandList_EndQuery              15 sptr,int,int
#comfunc global ID3D12VideoProcessCommandList_ResolveQueryData      16 sptr,int,int,int,sptr,int64
#comfunc global ID3D12VideoProcessCommandList_SetPredication        17 sptr,int64,int
#comfunc global ID3D12VideoProcessCommandList_SetMarker             18 int,sptr,int
#comfunc global ID3D12VideoProcessCommandList_BeginEvent            19 int,sptr,int
#comfunc global ID3D12VideoProcessCommandList_EndEvent              20
#comfunc global ID3D12VideoProcessCommandList_ProcessFrames         21 sptr,sptr,int,sptr
#comfunc global ID3D12VideoProcessCommandList_WriteBufferImmediate  22 int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。