PFND3DWDDM1_3DDI_GETMIPPACKING fonction de rappel (d3d10umddi.h)
Pour une ressource en mosaïque donnée, retourne le nombre de mips qui sont 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 empaqueté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, la valeur zéro doit être retournée.
pNumTilesForPackedMips
Pointeur vers une variable qui reçoit le nombre de vignettes dans laquelle s’intègrent les mips empaquetées, pour une tranche de tableau donnée.
Ce paramètre est ignoré si *pNumPackedMips retourne zéro.
Valeur de retour
Aucun
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 est NULL.
Les mips packed incluent des cas où plusieurs petites vignettes de partage mips et également mips pour lesquelles 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 informés des formes de mosaïques ou de la disposition pour les mips empaquetées et doivent simplement mapper toutes ou aucune des vignettes empaquetées si l’un des mipmaps est accessible. Sinon, le mappage observé de 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ées à être considérées comme faisant partie de l’ensemble de mips emballés. Sinon, le runtime supprime l’appareil sur un pilote non valide.
L’un des exemples de dimensions qu’un appareil peut regrouper validement 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 est au moins une vignette large mais inférieure à une vignette haute. Dans l’idéal, un appareil utilise la répartition des vignettes standard pour ce cas (afin que l’application puisse gérer les vignettes de manière standard). Si un appareil a besoin d’utiliser un mosaïque personnalisé, l’application n’est pas informé de la répartition des vignettes (seulement le nombre de vignettes impliquées dans l’emballage global) et perd donc une certaine liberté.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8.1,WDDM 1.3 |
| serveur minimum pris en charge | Windows Server 2012 R2 |
| plateforme cible | Bureau |
| d’en-tête | d3d10umddi.h (include D3d10umddi.h) |