ホーム › Media.MediaFoundation › ID3D12VideoDecodeCommandList

ID3D12VideoDecodeCommandList

COM

📘 Microsoft Learn (日本語) · English

IID3b60536e-ad29-4e64-a269-f853837e5e53継承元ID3D12CommandList自前メソッド開始 vtbl9

公式ドキュメント

ビデオデコード用のグラフィックスコマンドのリストをカプセル化します。

メソッド 14

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

vtbl 9 HRESULT Close()

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

戻り値

型: HRESULT

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

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

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

解説(Remarks)

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

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

vtbl 10 HRESULT Reset(ID3D12CommandAllocator* pAllocator)

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

pAllocator

ID3D12CommandAllocator*

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

戻り値

型: HRESULT

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

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

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

解説(Remarks)

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

vtbl 11 void ClearState()

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

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

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

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

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

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

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

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

クエリの実行を開始します。(ID3D12VideoDecodeCommandList::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)

クエリを終了します。(ID3D12VideoDecodeCommandList::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)

クエリからデータを抽出します。(ID3D12VideoDecodeCommandList::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)

述語値が指定された操作を満たす場合に、後続のコマンドを実行しないように指定します。(ID3D12VideoDecodeCommandList::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)

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

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

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

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

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

vtbl 20 void EndEvent()

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

vtbl 21 void DecodeFrame(ID3D12VideoDecoder* pDecoder, D3D12_VIDEO_DECODE_OUTPUT_STREAM_ARGUMENTS* pOutputArguments, D3D12_VIDEO_DECODE_INPUT_STREAM_ARGUMENTS* pInputArguments)

デコードフレーム操作をコマンドリストに記録します。

pDecoder	ID3D12VideoDecoder*	in	デコーダーインスタンスを表す ID3D12VideoDecoder インターフェイスへのポインター。
pOutputArguments	D3D12_VIDEO_DECODE_OUTPUT_STREAM_ARGUMENTS*	in	出力サーフェスおよび出力引数を指定する D3D12_VIDEO_DECODE_OUTPUT_STREAM_ARGUMENTS 構造体。
pInputArguments	D3D12_VIDEO_DECODE_INPUT_STREAM_ARGUMENTS*	in	入力ビットストリーム、参照フレーム、およびその他の入力パラメーターを指定する D3D12_VIDEO_DECODE_INPUT_STREAM_ARGUMENTS 構造体。

解説(Remarks)

ID3D12VideoDecodeCommandList1::DecodeFrame1 メソッドは、このメソッドと同じ機能を提供しますが、デコードヒストグラムのサポートが追加されています。

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

複数の 32 ビット即値を、コマンドストリームから直接、指定されたバッファーの場所へ書き込みます。(ID3D12VideoDecodeCommandList::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 を使用して書き込みます。

解説(Remarks)

この機能の対応状況は D3D12_FEATURE_DATA_D3D12_OPTIONS3::WriteBufferImmediateSupportFlags で指定されます。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_ID3D12VideoDecodeCommandList "{3B60536E-AD29-4E64-A269-F853837E5E53}"
#usecom global ID3D12VideoDecodeCommandList IID_ID3D12VideoDecodeCommandList "{}"
#comfunc global ID3D12VideoDecodeCommandList_Close                 9
#comfunc global ID3D12VideoDecodeCommandList_Reset                 10 sptr
#comfunc global ID3D12VideoDecodeCommandList_ClearState            11
#comfunc global ID3D12VideoDecodeCommandList_ResourceBarrier       12 int,var
#comfunc global ID3D12VideoDecodeCommandList_DiscardResource       13 sptr,var
#comfunc global ID3D12VideoDecodeCommandList_BeginQuery            14 sptr,int,int
#comfunc global ID3D12VideoDecodeCommandList_EndQuery              15 sptr,int,int
#comfunc global ID3D12VideoDecodeCommandList_ResolveQueryData      16 sptr,int,int,int,sptr,int64
#comfunc global ID3D12VideoDecodeCommandList_SetPredication        17 sptr,int64,int
#comfunc global ID3D12VideoDecodeCommandList_SetMarker             18 int,sptr,int
#comfunc global ID3D12VideoDecodeCommandList_BeginEvent            19 int,sptr,int
#comfunc global ID3D12VideoDecodeCommandList_EndEvent              20
#comfunc global ID3D12VideoDecodeCommandList_DecodeFrame           21 sptr,var,var
#comfunc global ID3D12VideoDecodeCommandList_WriteBufferImmediate  22 int,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ID3D12VideoDecodeCommandList "{3B60536E-AD29-4E64-A269-F853837E5E53}"
#usecom global ID3D12VideoDecodeCommandList IID_ID3D12VideoDecodeCommandList "{}"
#comfunc global ID3D12VideoDecodeCommandList_Close                 9
#comfunc global ID3D12VideoDecodeCommandList_Reset                 10 sptr
#comfunc global ID3D12VideoDecodeCommandList_ClearState            11
#comfunc global ID3D12VideoDecodeCommandList_ResourceBarrier       12 int,sptr
#comfunc global ID3D12VideoDecodeCommandList_DiscardResource       13 sptr,sptr
#comfunc global ID3D12VideoDecodeCommandList_BeginQuery            14 sptr,int,int
#comfunc global ID3D12VideoDecodeCommandList_EndQuery              15 sptr,int,int
#comfunc global ID3D12VideoDecodeCommandList_ResolveQueryData      16 sptr,int,int,int,sptr,int64
#comfunc global ID3D12VideoDecodeCommandList_SetPredication        17 sptr,int64,int
#comfunc global ID3D12VideoDecodeCommandList_SetMarker             18 int,sptr,int
#comfunc global ID3D12VideoDecodeCommandList_BeginEvent            19 int,sptr,int
#comfunc global ID3D12VideoDecodeCommandList_EndEvent              20
#comfunc global ID3D12VideoDecodeCommandList_DecodeFrame           21 sptr,sptr,sptr
#comfunc global ID3D12VideoDecodeCommandList_WriteBufferImmediate  22 int,sptr,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。