PFND3DWDDM1_3DDI_GETMIPPACKING fonction de rappel (d3d10umddi.h)

Pour une ressource en mosaïque donnée, retourne le nombre de mips emballés et le nombre de vignettes nécessaires pour stocker tous les mips emballés.

Syntaxe

PFND3DWDDM1_3DDI_GETMIPPACKING Pfnd3dwddm13DdiGetmippacking;

void Pfnd3dwddm13DdiGetmippacking(
  D3D10DDI_HDEVICE hDevice,
  D3D10DDI_HRESOURCE hTiledResource,
  UINT *pNumPackedMips,
  UINT *pNumTilesForPackedMips
)
{...}

Paramètres

hDevice

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

hTiledResource

Handle de la ressource en mosaïque.

pNumPackedMips

Pointeur vers une variable qui reçoit le nombre de mips qui sont emballés, pour une tranche de tableau donnée, y compris les mips qui n’utilisent pas les formes de vignette standard.

S’il n’y a pas d’emballage, une valeur de zéro doit être retournée.

pNumTilesForPackedMips

Pointeur vers une variable qui reçoit le nombre de vignettes dans laquelle les mips emballés s’ajustent, pour une tranche de tableau donnée.

Ce paramètre est ignoré si *pNumPackedMips retourne zéro.

Valeur de retour

None

Remarques

Le pilote peut utiliser la fonction de rappel pfnSetErrorCb pour définir un code d’erreur. Le pilote peut définir E_INVALIDARG si un paramètre d’entrée n’existe pas ou a la valeur NULL.

Les mips empaquetés incluent les cas où plusieurs petits mips partagent la ou les vignettes et les mips pour lesquels un appareil donné ne peut pas utiliser de formes de vignette standard. Il est possible qu’une ressource entière soit considérée comme empaquetée.

Les applications ne sont pas dites aux formes de vignette ou à la disposition pour les mips empaquetés et doivent simplement mapper toutes ou aucune des vignettes empaquetées si l’un des mipmaps est accessible. Sinon, le mappage observé des pixels individuels accessibles n’est pas défini et est spécifique au fournisseur de matériel indépendant (IHV).

Les Mipmaps qui ont des dimensions de pixels qui remplissent entièrement au moins une vignette de forme standard dans toutes les dimensions ne sont pas autorisés à être considérés comme faisant partie de l’ensemble de mips emballés. Sinon, le runtime supprime l’appareil sur un pilote non valide.
Un exemple de dimensions qu’un appareil peut valablement incorporer dans les vignettes emballées (ce qui signifie que l’IHV peut utiliser sa propre répartition de vignette personnalisée) est un mip qui a au moins une vignette de large, mais moins qu’une vignette haute. Dans l’idéal, un appareil utilise la répartition standard des vignettes pour ce cas (afin que l’application puisse gérer les vignettes de manière standard). Si un appareil a besoin d’utiliser un carrelage personnalisé, l’application n’est pas spécifiée sur la répartition des vignettes (uniquement le nombre de vignettes impliquées dans l’emballage global) et perd donc une certaine liberté.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1,WDDM 1.3
Serveur minimal pris en charge	Windows Server 2012 R2
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	d3d10umddi.h (include D3d10umddi.h)

Voir aussi

pfnSetErrorCb