PFND3DDDI_TEXBLT fonction de rappel (d3dumddi.h)

  • Article

La fonction TexBlt 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.

Syntaxe

PFND3DDDI_TEXBLT Pfnd3dddiTexblt;

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

Paramètres

hDevice

Handle de l’appareil d’affichage (contexte graphique).

unnamedParam2

pData [in]

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

Valeur retournée

TexBlt retourne S_OK ou un résultat d’erreur approprié si l’opération de bitblt de texture n’est pas effectué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 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 de 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 256x256 a huit niveaux de carte 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 aux sous-niveaux MIP-map.

Pour copier un niveau arbitraire d’une texture MIP-map, 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 est sûre.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible Desktop (Expérience utilisateur)
En-tête d3dumddi.h (inclure D3dumddi.h)

Voir aussi

Blt

D3DDDIARG_TEXBLT

D3DDDI_DEVICEFUNCS