PFND3DDDI_TEXBLT コールバック関数 (d3dumddi.h)

  • [アーティクル]

TexBlt 関数は、ソース テクスチャから移行先テクスチャへのビット ブロック転送 (ビットブレット) 操作を実行します。これには、ソース テクスチャのすべてのサブレベルが含まれます。

構文

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

HRESULT Pfnd3dddiTexblt(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}

パラメーター

hDevice

ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。

unnamedParam2

pData [in]

テクスチャビット演算のパラメーターを定義する D3DDDIARG_TEXBLT 構造体へのポインター。

戻り値

テクスチャ ビットレット操作が正常に実行されない場合、TexBlt はS_OKまたは適切なエラー結果を返します。

注釈

Microsoft Direct3D ランタイムは、ユーザー モードディスプレイ ドライバーの TexBlt 関数を呼び出して、ソース テクスチャから宛先テクスチャへのビットビット操作を実行するようにドライバーに通知します。 テクスチャは、立方環境マップにすることもできます。 ドライバーは、ソース テクスチャ内のD3DDDIARG_TEXBLT構造体の SrcRect メンバーによって指定された四角形を、移行先テクスチャの D3DDDIARG_TEXBLT の DstPoint メンバーによって指定された場所にコピーする必要があります。 宛先テクスチャとソース テクスチャはそれぞれ、 D3DDDIARG_TEXBLTの hDstResource ハンドルと hSrcResource ハンドルによって識別されます。

MIP マップテクスチャの場合、ドライバーはソース テクスチャに存在するすべての MIP マップ サブレベルもコピーする必要があります。 ソース テクスチャとターゲット テクスチャには、MIP マップ レベルの数が異なる場合があります。 この状況では、ドライバーは共通レベルをコピーする必要があります。 たとえば、256 x 256 ソース テクスチャに 8 つの MIP マップ レベルがあり、宛先が 6 レベルの 64 x 64 テクスチャの場合、ドライバーはソースから対応する 6 つのレベルをコピーする必要があります。 ターゲット テクスチャの最上位 MIP レベルの寸法は、常にソース テクスチャの最上位 MIP レベルの寸法以下であることに注意してください。

ソース ハンドルと変換先ハンドルは常に最上位のサーフェスを参照し、MIP マップ サブレベルは参照しません。

MIP マップ テクスチャの任意のレベルをコピーするために、ランタイムは代わりにドライバーの Blt 関数を呼び出します。

ソース テクスチャとターゲット テクスチャのピクセル形式は同じであり、一般に、指定されたビットレット操作は安全に実行できます。

要件

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

こちらもご覧ください

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS