D3DDDIARG_COMPOSERECTS構造体 (d3dumddi.h)

  • [アーティクル]

D3DDDIARG_COMPOSERECTS構造体は、四角形の領域を構成するために使用されるパラメーターを記述します。

構文

typedef struct _D3DDDIARG_COMPOSERECTS {
  [in] HANDLE                hSrcResource;
  [in] UINT                  SrcSubResourceIndex;
  [in] HANDLE                hDstResource;
  [in] UINT                  DstSubResourceIndex;
  [in] HANDLE                hSrcRectDescsVB;
  [in] UINT                  NumRects;
  [in] HANDLE                hDstRectDescsVB;
  [in] D3DDDI_COMPOSERECTSOP Operation;
  [in] INT                   XOffset;
  [in] INT                   YOffset;
} D3DDDIARG_COMPOSERECTS;

メンバー

[in] hSrcResource

ソース サーフェスを含むソース リソースへのハンドル。 サーフェスが作成されると、ユーザー モードディスプレイ ドライバーは、Format メンバーのD3DDDIFMT_A1 (ピクセルあたり 1 ビット) の値を受け取り、ドライバーの CreateResource 関数の呼び出しでD3DDDIARG_CREATERESOURCE構造体の Flags メンバーの TextApi ビット フィールド フラグを受け取ります。 サーフェスはテクスチャの一部として作成する必要があります。

[in] SrcSubResourceIndex

ソース リソース内のソース サーフェスへのインデックス。

[in] hDstResource

変換先のサーフェスを含むターゲット リソースへのハンドル。 サーフェスが作成されると、ユーザー モードディスプレイ ドライバーは、ドライバーの CreateResource の呼び出しで D3DDDIARG_CREATERESOURCE の Format メンバーのD3DDDIFMT_A1 (ピクセルあたり 1 ビット) の値を受け取ります。 サーフェスはテクスチャの一部として作成する必要があります。 TextApi ビット フィールド フラグを使用してサーフェスが作成されている可能性があります。

[in] DstSubResourceIndex

変換先リソース内の変換先サーフェスへのインデックス。

[in] hSrcRectDescsVB

D3DCOMPOSERECTSRCDESC構造体の配列を含む頂点バッファーへのハンドル。 配列内の各要素は、ソースサーフェス上に四角形を定義します。 頂点バッファーが作成されると、ユーザー モードディスプレイ ドライバーは、ドライバーの CreateResource 関数の呼び出しで、D3DDDIARG_CREATERESOURCE構造体の Flags メンバーで TextApi ビット フィールド フラグを受け取ります。

[in] NumRects

コピーする四角形の領域の数。 これは、hDstRectDescsVB メンバーによって識別される頂点バッファー内のD3DCOMPOSERECTDSTDESC構造体の数です。 ドライバーは、 NumRects が 0xFFFF より大きいに設定されている ComposeRects の呼び出しを無視する必要があります。

[in] hDstRectDescsVB

D3DCOMPOSERECTDSTDESC構造体の配列を含む頂点バッファーへのハンドル。 配列内の各要素は、コピー先サーフェス上のソース四角形をコピーする場所を定義します。 詳細については、「解説」を参照してください。 頂点バッファーが作成されると、ユーザー モードディスプレイ ドライバーは、ドライバーの CreateResource 関数の呼び出しで、D3DDDIARG_CREATERESOURCE構造体の Flags メンバーで TextApi ビット フィールド フラグを受け取ります。

[in] Operation

四角形の領域を構成する方法を説明するD3DDDI_COMPOSERECTSOP値。 このメンバーには、次のいずれかの値を指定できます。

Value 意味
D3DDDICOMPOSERECTS_COPY 各ソース ビットをコピー先にコピーします。
D3DDDICOMPOSERECTS_OR OR 操作でソース ビットと変換先ビットを結合し、コピー先にコピーします。
D3DDDICOMPOSERECTS_AND AND 操作でソース ビットと変換先ビットを結合し、コピー先にコピーします。
D3DDDICOMPOSERECTS_NEG ソース ビットの負の部分と宛先ビットを結合し、コピー先にコピーします。 [Dest bit & (~ Src ビット)]

[in] XOffset

すべてのターゲット四角形領域の x 座標に追加するオフセット。 オフセットに負の値を指定すると、結果として得られる四角形が拒否またはクリップされる可能性があります。

[in] YOffset

すべての移動先の四角形領域の y 座標に追加するオフセット。 オフセットに負の値を指定すると、結果として得られる四角形が拒否またはクリップされる可能性があります。

注釈

作成命令を含む頂点バッファーは、D3DUSAGE_TEXTAPI使用して作成されます。 次のコードでは、頂点バッファー配列に含まれる構造体を定義します。 これらの構造の詳細については、DirectX SDK のドキュメントを参照してください。

struct D3DCOMPOSERECTSRCDESC {
USHORT X, Y;          // Coordinates of top-left corner
USHORT width, height; // Width and height of the glyph in bits
};

struct D3DCOMPOSERECTDSTDESC {
USHORT RectDescIndex; // Index of one of the D3DCOMPOSERECTSRCDESC structures in the vertex buffer represented by hSrcRectDescsVB
USHORT reserved;      // Use to align the struct and fields to good boundaries
SHORT X, Y;            // Position in bits in the destination surface
};

要件

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

こちらもご覧ください

ComposeRects

Rect