PFND3DDDI_TEXBLT1 fonction de rappel (d3dumddi.h)

Effectue une opération de transfert de bloc de bits (bitblt) d’une texture source vers une texture de destination, y compris tous les sous-niveaux de la texture source. Implémenté par les pilotes d’affichage en mode utilisateur WINDOWS (WDDM) 1.2 ou ultérieur.

Syntaxe

PFND3DDDI_TEXBLT1 Pfnd3dddiTexblt1;

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

Paramètres

hDevice

Handle pour le périphérique d’affichage (contexte graphique).

unnamedParam2

pData [in]

Pointeur vers une structure D3DDDIARG_TEXBLT1 qui définit les paramètres de l’opération de bitblt de texture.

Valeur retournée

Retourne S_OK ou un résultat d’erreur approprié si l’opération de bitblt de texture n’est pas exécutée avec succès.

Remarques

Le runtime Microsoft Direct3D appelle la fonction TexBlt du pilote d’affichage en mode utilisateur pour informer le pilote d’effectuer une opération bitblt à partir d’une texture source vers une texture de destination. Une texture peut également être une carte d’environnement cubique. Le pilote doit copier le rectangle spécifié par le membre SrcRect de la structure D3DDDIARG_TEXBLT dans la texture source vers l’emplacement spécifié par le membre DstPoint de D3DDDIARG_TEXBLT dans la texture de destination. Les textures destination et source sont identifiées par les handles hDstResource et hSrcResource de D3DDDIARG_TEXBLT, respectivement.

Pour les textures MIP mappées, le pilote doit également copier tous les sous-niveaux de mappage MIP présents dans la texture source. Les textures source et de destination peuvent éventuellement contenir différents nombres de niveaux de carte MIP. Dans ce cas, le pilote doit copier les niveaux communs. Par exemple, si une texture source 256 x 256 comporte huit niveaux de mappage MIP et si la destination est une texture 64x64 avec six niveaux, le pilote doit copier les six niveaux correspondants à partir de la source. Notez que les dimensions du niveau MIP supérieur de la texture de destination sont toujours inférieures ou égales aux dimensions du niveau MIP supérieur de la texture source.

Les handles source et de destination font toujours référence aux surfaces de niveau supérieur et jamais à un sous-niveau de carte MIP.

Pour copier un niveau arbitraire d’une texture de carte MIP, le runtime appelle la fonction Blt du pilote à la place.

Les formats de pixels des textures source et de destination sont identiques et, en général, l’opération bitblt spécifiée peut être effectuée en toute sécurité.

Configuration requise

Voir aussi

Blt

D3DDDIARG_TEXBLT1

D3DDDI_DEVICEFUNCS