PFND3DDDI_TEXBLT1 コールバック関数 (d3dumddi.h)
ソース テクスチャのすべてのサブレベルを含む、ソース テクスチャから宛先テクスチャへのビット ブロック転送 (bitblt) 操作を実行します。 Windows ディスプレイ ドライバー モデル (WDDM) 1.2 以降のユーザー モード ディスプレイ ドライバーによって実装されます。
構文
PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;
HRESULT Pfnd3dddiTexblt1(
HANDLE hDevice,
const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}
パラメーター
hDevice
ディスプレイ デバイスへのハンドル (グラフィックス コンテキスト)。
unnamedParam2
pData [in]
テクスチャ ビットレット操作のパラメーターを定義する D3DDDIARG_TEXBLT1 構造体へのポインター。
戻り値
テクスチャ ビットブレット操作が正常に実行されない場合は、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 8 |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dumddi.h (D3dumddi.h を含む) |