FORMATOP 構造体 (d3dumddi.h)

[アーティクル]
03/08/2023

FORMATOP 構造体は、このようなサーフェスで実行できるサーフェスの形式と操作を記述します。

構文

typedef struct _FORMATOP {
  [in]  D3DDDIFORMAT Format;
  [out] UINT         Operations;
  [out] UINT         FlipMsTypes;
  [out] UINT         BltMsTypes;
  [out] UINT         PrivateFormatBitCount;
} FORMATOP;

メンバー

[in] Format

サーフェスのピクセル形式を示す D3DDDIFORMAT型指定された値。

[out] Operations

Format メンバーで指定されたピクセル形式のサーフェスに対して実行できる操作を示す、次のフラグの有効なビットごとの OR。次のフラグの一部は、他のフラグを使用する必要があることを意味します。ドライバーが他のフラグを意味するフラグを設定する場合、ドライバーは暗黙的なフラグを設定する必要はありません、Direct3D ランタイムは、暗黙的なフラグの使用を決定します。

FORMATOP_TEXTURE (0x00000001L)

指定したピクセル形式のサーフェスは、MIP マップテクスチャとして使用できます。

FORMATOP_VOLUMETEXTURE (0x00000002L)

この形式のサーフェスは、ボリュームテクスチャとして使用できます。このフラグは、FORMATOP_TEXTUREとは無関係であることに注意してください。そのため、ピクセル形式は、従来の MIP マップテクスチャではなく、ボリュームテクスチャに使用できます。

FORMATOP_CUBETEXTURE (0x00000004L)

この形式のサーフェスは、立方環境マップテクスチャとして使用できます。このフラグは、FORMATOP_TEXTUREとは無関係であることに注意してください。そのため、ピクセル形式は、従来の MIP マップテクスチャではなく、立方環境マップテクスチャに使用できます。

FORMATOP_OFFSCREEN_RENDERTARGET (0x00000008L)

現在の表示モードのピクセル形式がFORMATOP_DISPLAYMODEおよびFORMATOP_3DACCELERATIONで報告された場合、表示モードのピクセル形式に関係なく、この形式のサーフェスをオフスクリーンレンダーターゲットとして使用できます。現在の表示モードのピクセル形式にこれらのフラグが設定されていない場合、レンダーターゲットがオフスクリーンであっても、このモードでは 3-D アクセラレーションは使用できません。 FORMATOP_OFFSCREEN_RENDERTARGET フラグを FORMATOP_TEXTURE と組み合わせて、デバイスが指定したピクセル形式のテクスチャにレンダリングできることを示すことができます。

FORMATOP_OFFSCREEN_RENDERTARGET フラグは、FORMATOP_SAME_FORMAT_RENDERTARGETフラグとFORMATOP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET フラグも意味します。

FORMATOP_SAME_FORMAT_RENDERTARGET (0x00000010L)

この形式のサーフェスはレンダーターゲットとして使用できますが、サーフェスのピクセル形式が現在の表示モードのピクセル形式と一致する場合にのみ使用できます。このフラグは、オフスクリーンレンダーターゲットにのみ適用されるわけではありませんが、表示モードのピクセル形式で指定して、レンダリングターゲットの機能を示すことができます。このフラグを FORMATOP_TEXTURE と組み合わせて、デバイスが指定したピクセル形式のテクスチャにレンダリングできることを示すことができます。

FORMATOP_SAME_FORMAT_RENDERTARGET フラグは、FORMATOP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET フラグも意味します。

FORMATOP_ZSTENCIL (0x00000040L)

この形式のサーフェスは、Z/ステンシルバッファーとして使用できますが、Z/ステンシルサーフェスの深度が深度バッファーがアタッチされているレンダリングターゲットの色深度と一致する場合にのみ使用できます。 Z/ステンシルとカラーバッファーの深度の一致を決定する場合は、ピクセルストライドを使用します。

FORMATOP_ZSTENCIL_WITH_ARBITRARY_COLOR_DEPTH (0x00000080L)

この形式のサーフェスは、サーフェスがアタッチされているレンダーターゲットの色深度に関係なく、Z/ステンシルバッファーとして使用できます。

FORMATOP_ZSTENCIL_WITH_ARBITRARY_COLOR_DEPTH フラグは、FORMATOP_ZSTENCIL フラグも意味します。

FORMATOP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET (0x00000100L)

現在の表示モードが同じ深度でアルファチャネルが無視される場合、この形式のサーフェスをレンダーターゲットとして使用できます。たとえば、表示モードがX8R8G8B8のときにデバイスが A8R8G8B8 にレンダリングできる場合、A8R8G8B8の書式操作リストエントリには、このフラグが設定されている必要があります。

FORMATOP_DISPLAYMODE (0x00000400L)

ドライバーモデルでサポートされているこのピクセル形式の表示モード (Flip を含む)。このフラグはアルファ形式では設定しないでください。

FORMATOP_3DACCELERATION (0x00000800L)

グラフィックスアクセラレータは、このピクセル形式の表示モードの場合、Microsoft Direct3D アクセラレータの一部のレベルをサポートでき、ドライバーはこのモードでコンテキストを作成できます (一部のレンダーターゲット形式の場合)。このフラグは、(FORMATOP_DISPLAYMODEを指定して) 表示モード形式をレポートする場合にのみ使用できます。このフラグは、オフスクリーンレンダーターゲットの形式をレポートするために使用しないでください。

FORMATOP_PIXELSIZE (0x00001000L)

PrivateFormatBitCount メンバーの形式のピクセルあたりのビット数を入力したドライバー。

ドライバーでマネージドサーフェスとテクスチャでプライベート形式 (ドライバーで処理できますが、Direct3D ランタイムではネイティブに処理できない形式) を使用する必要がある場合、ドライバーは PrivateFormatBitCount でFORMATOP_PIXELSIZEとピクセルサイズを指定する必要があります。

FORMATOP_CONVERT_TO_ARGB (0x00002000L)

この形式のソースサーフェスは、FORMATOP_MEMBEROFGROUP_ARGB フラグが指定された RGB ピクセル形式の任意のターゲットサーフェスに変換できます。

FORMATOP_OFFSCREENPLAIN (0x00004000L)

ドライバーは、この形式のサーフェスを拡大したり、色を塗りつぶしたりできます。

FORMATOP_SRGBREAD (0x00008000L)

この形式のサーフェスは、 sRGB 形式のテクスチャとして読み取ることができます (つまり、サンプラーは検索されたデータを線形化します)。

FORMATOP_BUMPMAP (0x00010000L)

この形式のサーフェスは、バンプ環境マップテクスチャとして使用できます。このフラグは、FORMATOP_TEXTUREとは無関係であることに注意してください。そのため、ピクセル形式は、従来の MIP マップテクスチャではなく、バンプ環境マップテクスチャに使用できます。

FORMATOP_DMAP (0x00020000L)

ディスプレイスメントマップサンプラーは、この形式のサーフェスをサンプリングできます。

FORMATOP_NOFILTER (0x00040000L)

この形式のサーフェスは、テクスチャフィルタリングでは使用できません。

FORMATOP_MEMBEROFGROUP_ARGB (0x00080000L)

この形式のターゲットサーフェスは、FORMATOP_CONVERT_TO_ARGB フラグが指定されたピクセル形式の任意のソースサーフェスから変換できます。ドライバーは、チャネルごとに少なくとも 5 ビットの色情報を持つ ARGB サーフェスに対してのみ、FORMATOP_MEMBEROFGROUP_ARGBを指定できます。つまり、D3DDDIFMT_A1R5G5B5形式は有効ですが、D3DDDIFMT_A4R4G4B4形式は無効です。ドライバーで無効な形式のFORMATOP_MEMBEROFGROUP_ARGBが指定されている場合、Direct3D ランタイムは Direct3D HAL の読み込みを妨げます。このフラグは ARGB 形式を示しますが、ランタイムではドライバーが XRGB 形式 (たとえば、D3DDDIFMT_X1R5G5B5) を使用してサーフェスを指定することもできます。

FORMATOP_SRGBWRITE (0x00100000L)

この形式のサーフェスは、 sRGB 形式のターゲットとしてに書き込むことができます (つまり、ピクセルパイプは、出力のデータをこの形式に線引きします)。

FORMATOP_NOALPHABLEND (0x00200000L)

この形式のサーフェスはアルファブレンドでは使用できません。

FORMATOP_AUTOGENMIPMAP (0x00400000L)

この形式の MIP マップテクスチャのサブレベルは、自動的に生成できます。ドライバーが GenerateMipSubLevels 関数の呼び出しを受信するには、このフラグを公開する必要があります。

FORMATOP_VERTEXTEXTURE (0x00800000L)

頂点テクスチャサンプラーでは、この形式のサーフェスを使用できます。つまり、頂点テクスチャとして使用できるのは、この形式のサーフェスだけです。

FORMATOP_NOTEXCOORDWRAPNORMIP (0x01000000L)

この形式のサーフェスは、2 の累乗ではないディメンションを持つ 2-D テクスチャのテクスチャマッピングにのみ条件付きで使用できます。詳細については、D3DPRIMCAPS リファレンスページの「D3DPTEXTURECAPS_POW2とD3DPTEXTURECAPS_NONPOW2CONDITIONALの定義」を参照してください。

FORMATOP_PLANAR (0x02000000L)

この形式のサーフェスは平面とパックです。 Direct3D ランタイムは、サーフェスが失われ、ピッチの高さの一般的な計算が不可能な場合に、平面形式のサーフェスでユーザーモードディスプレイドライバーの Lock 関数を呼び出す場合にバッファーを割り当てる必要があります。ほとんどの形式は、Microsoft DirectX ビデオアクセラレーションで使用される形式 (YUV 形式など) を除いてパックされています。

FORMATOP_OVERLAY (0x04000000L)

この形式のサーフェスは、オーバーレイ操作に使用されます。

FORMATOP_CAPTURE (0x08000000L)

D3DDDI_RESOURCEFLAGS2構造体の VideoEncoder メンバーが設定されている場合は、この形式のサーフェスをキャプチャバッファーとして使用できます。

Windows 8 以降でサポートされています。

FORMATOP_VIDEO_ENCODER (0x10000000L)

D3DDDI_RESOURCEFLAGS2構造体の VideoEncoder メンバーが設定されている場合は、この形式のサーフェスをビデオエンコーダー入力リソースとして使用できます。

Windows 8 以降でサポートされています。

FORMATOP_MULTIPLANE_OVERLAY (0x20000000L)

この形式のサーフェスでは、マルチプレーンオーバーレイがサポートされています。

Windows 8 以降でサポートされています。

[out] FlipMsTypes

全画面表示の複数サンプリング用の 32 ビットマスク。

[out] BltMsTypes

ウィンドウ化された複数サンプリング用の 32 ビットマスク。

[out] PrivateFormatBitCount

ドライバーに対してプライベートなピクセル形式のピクセルあたりのビット数 (つまり、 D3DDDIFORMAT 列挙型で定義されている標準的なピクセル形式の 1 つではありません)。

要件

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

こちらもご覧ください

D3DDDIARG_GETCAPS

D3DDDICAPS_TYPE

D3DDDIFORMAT

D3DDDI_RESOURCEFLAGS2

GetCaps

FORMATOP 構造体 (d3dumddi.h)

構文

メンバー

FORMATOP_TEXTURE (0x00000001L)

FORMATOP_VOLUMETEXTURE (0x00000002L)

FORMATOP_CUBETEXTURE (0x00000004L)

FORMATOP_OFFSCREEN_RENDERTARGET (0x00000008L)

FORMATOP_SAME_FORMAT_RENDERTARGET (0x00000010L)

FORMATOP_ZSTENCIL (0x00000040L)

FORMATOP_ZSTENCIL_WITH_ARBITRARY_COLOR_DEPTH (0x00000080L)

FORMATOP_SAME_FORMAT_UP_TO_ALPHA_RENDERTARGET (0x00000100L)

FORMATOP_DISPLAYMODE (0x00000400L)

FORMATOP_3DACCELERATION (0x00000800L)

FORMATOP_PIXELSIZE (0x00001000L)

FORMATOP_CONVERT_TO_ARGB (0x00002000L)

FORMATOP_OFFSCREENPLAIN (0x00004000L)

FORMATOP_SRGBREAD (0x00008000L)

FORMATOP_BUMPMAP (0x00010000L)

FORMATOP_DMAP (0x00020000L)

FORMATOP_NOFILTER (0x00040000L)

FORMATOP_MEMBEROFGROUP_ARGB (0x00080000L)

FORMATOP_SRGBWRITE (0x00100000L)

FORMATOP_NOALPHABLEND (0x00200000L)

FORMATOP_AUTOGENMIPMAP (0x00400000L)

FORMATOP_VERTEXTEXTURE (0x00800000L)

FORMATOP_NOTEXCOORDWRAPNORMIP (0x01000000L)

FORMATOP_PLANAR (0x02000000L)

FORMATOP_OVERLAY (0x04000000L)

FORMATOP_CAPTURE (0x08000000L)

FORMATOP_VIDEO_ENCODER (0x10000000L)

FORMATOP_MULTIPLANE_OVERLAY (0x20000000L)

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース