DXVADDI_DECODEBUFFERDESC構造体 (d3dumddi.h)

[アーティクル]
02/06/2025

DXVADDI_DECODEBUFFERDESC構造体は、ホストデコーダーからアクセラレータに現在渡されているバッファーを記述します。

構文

typedef struct _DXVADDI_DECODEBUFFERDESC {
  [in] HANDLE            hBuffer;
  [in] D3DDDIFORMAT      CompressedBufferType;
  [in] UINT              BufferIndex;
  [in] UINT              DataOffset;
  [in] UINT              DataSize;
  [in] UINT              FirstMBaddress;
  [in] UINT              NumMBsInBuffer;
  [in] UINT              Width;
  [in] UINT              Height;
  [in] UINT              Stride;
  [in] UINT              ReservedBits;
  [in] DXVADDI_PVP_HW_IV *pCipherCounter;
} DXVADDI_DECODEBUFFERDESC;

メンバーズ

[in] hBuffer

バッファーへのハンドル。

[in] CompressedBufferType

バッファーのピクセル形式を示す D3DDDIFORMAT型指定された値。

[in] BufferIndex

引っ込み思案。このメンバーは使用しないでください。詳細については、「解説」セクションを参照してください。

[in] DataOffset

バッファーの先頭からの関連データのオフセット (バイト単位)。現在、このメンバーの使用は値 0 に制限されています。

[in] DataSize

バッファー内の関連するデータの量 (バイト単位)。バッファー内のコンテンツの最後のバイトの位置は、DataOffset の値に、DataSize から 1 を引いた値を加えた値です。

[in] FirstMBaddress

アクセラレータに渡されるバッファー内の最初のマクロブロックのマクロブロックアドレス。マクロブロックアドレスは、ラスタースキャンの順序で指定されます。アドレスは、DXVA_PictureParameters 構造体のメンバーによって決定されます。次の表に、マクロブロックアドレスの例を示します。

マクロブロックの	アドレス
左上	ゼロ
右上	DXVA_PictureParametersの wPicWidthInMBminus1。
左下	wPicHeightInMBminus1 x (wPicWidthInMBminus1+1)。 DXVA_PictureParametersのメンバー。
右下	(wPicHeightInMBminus1+1) x (wPicWidthInMBminus1+1)-1. DXVA_PictureParameのメンバー

データバッファーが次のいずれかの種類の場合、FirstMBaddress メンバーは 0 である必要があります。画像デコードパラメーター、逆量子化マトリックス、スライス制御、ビットストリームデータ、AYUV、IA44/AI44、DPXD、Highlight、DCCMD。

データバッファーが残差ブロックデータバッファーの場合、FirstMBaddress は、対応するマクロブロック制御コマンドバッファーと同じ値を持つ必要があります。

[in] NumMBsInBuffer

スキップされたマクロブロックを含む、バッファー内のデータのマクロブロックの数。データバッファーが画像デコードパラメーター、逆量子化マトリックス、AYUV、IA44/AI44、DPXD、Highlight、DCCMD のいずれかの種類の場合、このメンバーは 0 である必要があります。

NumMBsInBuffer の値は、次の表に示すように、使用されているデータバッファーの種類によって異なります。

バッファーの種類	NumMBsInBuffer の値
Macroblock コントロールコマンド	MBskipsFollowing のすべての値の合計。マクロブロックコントロールコマンドバッファー内のマクロブロックコントロールコマンドの数に追加されます。
残差ブロック	対応するマクロブロック制御コマンドバッファーの場合と同じ値。
Slice-control コマンド	スライスコントロールバッファー内の DXVA_SliceInfo 構造体の wNumberMBsInSlice メンバーの値。
Bitstream	対応するスライス制御コマンドバッファーの場合と同じ値。

[in] Width

引っ込み思案。このメンバーは使用しないでください。詳細については、「解説」セクションを参照してください。

[in] Height

引っ込み思案。このメンバーは使用しないでください。詳細については、「解説」セクションを参照してください。

[in] Stride

引っ込み思案。このメンバーは使用しないでください。詳細については、「解説」セクションを参照してください。

[in] ReservedBits

パッキングとアラインメントに使用される予約済みビット。このメンバーは 0 である必要があります。

[in] pCipherCounter

128 ビットの保護されたビデオパス (PVP) 値を含む DXVADDI_PVP_HW_IV 構造体へのポインター。

備考

DXVADDI_DECODEBUFFERDESC構造体の配列は、バッファー記述リストと呼ばれます。一連のバッファーがホストデコーダーからハードウェアアクセラレータに送信されると、バッファー記述リストが送信されてバッファーが記述されます。バッファー記述リストには、このセット内のバッファーごとに 1 つのDXVADDI_DECODEBUFFERDESC構造体が含まれています。バッファー記述リストは、最初の型の最初のバッファーのDXVADDI_DECODEBUFFERDESC構造体で始まり、その後に同じ型の次のバッファーのDXVADDI_DECODEBUFFERDESC構造体で始まります。その後、バッファー記述リストは、次の型の最初のバッファーのDXVADDI_DECODEBUFFERDESC構造体で続行されます。このリスト全体は、D3DDDIARG_DECODEEXECUTE 構造体に含まれています。

Microsoft DirectX Video Acceleration (VA) バージョン 2.0 では、DirectX VA 1.0 で使用されるプライベートサーフェスではなく Microsoft Direct3D サーフェスが使用されるため、ユーザーモードディスプレイドライバーは、BufferIndex、Width、Heightの値ではなく、指定された圧縮バッファーの種類からインデックス、幅、高さ、およびストライドの値を取得します。ストライド メンバーを します。実際、Microsoft Direct3D ランタイムはこれらのメンバーを 0 に設定します。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
ヘッダー	d3dumddi.h (D3dumddi.h を含む)

次の方法で共有

DXVADDI_DECODEBUFFERDESC構造体 (d3dumddi.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース