PFND3DDDI_TEXBLT Rückruffunktion (d3dumddi.h)
Die TexBlt-Funktion führt einen Bitblockübertragungsvorgang (Bitblt) von einer Quelltextur zu einer Zieltextur aus, einschließlich aller Unterebenen der Quelltextur.
Syntax
PFND3DDDI_TEXBLT Pfnd3dddiTexblt;
HRESULT Pfnd3dddiTexblt(
HANDLE hDevice,
const D3DDDIARG_TEXBLT *unnamedParam2
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
pData [in]
Ein Zeiger auf eine D3DDDIARG_TEXBLT-Struktur , die die Parameter für den Texturbitbltvorgang definiert.
Rückgabewert
TexBlt gibt S_OK oder ein entsprechendes Fehlerergebnis zurück, wenn der Texturbitbltvorgang nicht erfolgreich ausgeführt wird.
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) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | d3dumddi.h (include D3dumddi.h) |