PFND3DWDDM1_3DDI_GETMIPPACKING Rückruffunktion (d3d10umddi.h)
Gibt für eine bestimmte nebeneinander angeordnete Ressource zurück, wie viele Mips verpackt sind und wie viele Kacheln zum Speichern aller verpackten Mips benötigt werden.
Syntax
PFND3DWDDM1_3DDI_GETMIPPACKING Pfnd3dwddm13DdiGetmippacking;
void Pfnd3dwddm13DdiGetmippacking(
D3D10DDI_HDEVICE hDevice,
D3D10DDI_HRESOURCE hTiledResource,
UINT *pNumPackedMips,
UINT *pNumTilesForPackedMips
)
{...}
Parameter
hDevice
Ein Handle für das Anzeigegerät (Grafikkontext).
hTiledResource
Ein Handle für die nebeneinander angeordnete Ressource.
pNumPackedMips
Ein Zeiger auf eine Variable, die die Anzahl der mips empfängt, die für ein bestimmtes Arraysegment gepackt sind, einschließlich aller Mips, die die standardmäßigen Kachelformen nicht verwenden.
Wenn keine Verpackung vorhanden ist, sollte ein Wert von Null zurückgegeben werden.
pNumTilesForPackedMips
Ein Zeiger auf eine Variable, die die Anzahl der Kacheln empfängt, in die die verpackten Mips passen, für ein bestimmtes Arraysegment.
Dieser Parameter wird ignoriert, wenn *pNumPackedMips Null zurückgibt.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen. Der Treiber kann E_INVALIDARG festlegen, wenn kein Eingabeparameter vorhanden ist oder NULL-ist.
Verpackte Mips umfassen Fälle, in denen mehrere kleine Mips Kacheln und mips teilen, für die ein bestimmtes Gerät keine Standardkachelformen verwenden kann. Es ist möglich, dass eine gesamte Ressource als gepackt betrachtet werden kann.
Anwendungen werden den Kachelformen oder dem Layout für verpackte Mips nicht mitgeteilt und müssen einfach alle oder keine der verpackten Kacheln zuordnen, wenn auf eine der Mipmaps zugegriffen werden soll. Andernfalls ist die beobachtete Zuordnung einzelner Pixel nicht definiert und für den unabhängigen Hardwareanbieter (IHV) spezifisch.
Mipmaps mit Pixelabmessungen, die mindestens eine standardförmige Kachel in allen Dimensionen vollständig ausfüllen, dürfen nicht als Teil der Gruppe von verpackten Mips betrachtet werden. Andernfalls entfernt die Laufzeit das Gerät auf einem ungültigen Treiber.
Ein Beispiel für Dimensionen, die ein Gerät gültig in die verpackten Kacheln einklüften kann (d. h. der IHV kann seine eigene benutzerdefinierte Kachelaufschlüsselung verwenden) ist ein Mip, der mindestens eine Kachel breit, aber weniger als eine Kachel hoch ist. Im Idealfall würde ein Gerät jedoch die Standardkachelaufschlüsselung für diesen Fall verwenden (sodass die Anwendung die Kacheln standardmäßig verwalten kann). Wenn ein Gerät eine benutzerdefinierte Tilung verwenden muss, wird der Anwendung nicht mitgeteilt, was die Kachelaufschlüsselung ist (nur wie viele Kacheln an der Verpackung insgesamt beteiligt sind), und so verliert einige Freiheiten.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1,WDDM 1.3 |
| mindestens unterstützte Server- | Windows Server 2012 R2 |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |