PFND3DDDI_TEXBLT1 Rückruffunktion (d3dumddi.h)

Führt einen Bitblockübertragungsvorgang (Bitblt) von einer Quelltextur zu einer Zieltextur aus, einschließlich aller Unterebenen der Quelltextur. Implementiert durch Windows Display Driver Model (WDDM) 1.2 oder höher Benutzermodusanzeigetreiber.

Syntax

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

HRESULT Pfnd3dddiTexblt1(
  HANDLE hDevice,
  const D3DDDIARG_TEXBLT1 *unnamedParam2
)
{...}

Parameter

hDevice

Ein Handle für das Anzeigegerät (Grafikkontext).

unnamedParam2

pData [in]

Ein Zeiger auf eine D3DDDIARG_TEXBLT1-Struktur , die die Parameter für den Texturbitblt-Vorgang definiert.

Rückgabewert

Gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn der Texturbitbltvorgang nicht erfolgreich ausgeführt wurde.

Hinweise

Die Microsoft Direct3D-Runtime ruft die TexBlt-Funktion des Benutzermodusanzeigetreibers auf, um den Treiber zu informieren, einen Bitblt-Vorgang von einer Quelltextur zu einer Zieltextur auszuführen. Eine Textur kann auch eine kubische Umgebungskarte sein. Der Treiber sollte das Rechteck kopieren, das durch das SrcRect-Element der D3DDDIARG_TEXBLT-Struktur in der Quelltextur angegeben wird, an den Speicherort, der vom DstPoint-Element von D3DDDIARG_TEXBLT in der Zieltextur angegeben wird. Die Ziel- und Quelltexturen werden durch die hDstResource - bzw . hSrcResource-Handles von D3DDDIARG_TEXBLT identifiziert.

Für MIP-zugeordnete Texturen muss der Treiber auch alle MIP-Kartenunterebenen kopieren, die in der Quelltextur vorhanden sind. Die Quell- und Zieltexturen können möglicherweise eine unterschiedliche Anzahl von MIP-Kartenebenen enthalten. In dieser Situation sollte der Treiber die allgemeinen Ebenen kopieren. Wenn eine Quelltextur von 256 x 256 beispielsweise acht MIP-Kartenebenen aufweist und das Ziel eine 64x64-Textur mit sechs Ebenen ist, sollte der Treiber die sechs entsprechenden Ebenen aus der Quelle kopieren. Beachten Sie, dass die Dimensionen der obersten MIP-Ebene der Zieltextur immer kleiner oder gleich den Dimensionen der obersten MIP-Ebene der Quelltextur sind.

Die Quell- und Zielhandles beziehen sich immer auf die Oberflächen der obersten Ebene und nie auf eine MIP-Zuordnungsunterebene.

Um eine beliebige Ebene einer MIP-Kartentextur zu kopieren, ruft die Runtime stattdessen die Blt-Funktion des Treibers auf.

Die Pixelformate der Quell- und Zieltexturen sind identisch, und im Allgemeinen kann der angegebene Bitblt-Vorgang sicher ausgeführt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Desktop
Kopfzeile	d3dumddi.h (include D3dumddi.h)

Weitere Informationen

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS