PFND3D10DDI_RESOURCERESOLVESUBRESOURCE Rückruffunktion (d3d10umddi.h)
Die ResourceResolveSubresource--Funktion löst mehrere Beispiele in einem Pixel auf.
Syntax
PFND3D10DDI_RESOURCERESOLVESUBRESOURCE Pfnd3d10ddiResourceresolvesubresource;
void Pfnd3d10ddiResourceresolvesubresource(
D3D10DDI_HDEVICE unnamedParam1,
D3D10DDI_HRESOURCE unnamedParam2,
UINT unnamedParam3,
D3D10DDI_HRESOURCE unnamedParam4,
UINT unnamedParam5,
DXGI_FORMAT unnamedParam6
)
{...}
Parameter
unnamedParam1
hDevice [in]
Ein Handle für das Anzeigegerät (Grafikkontext).
unnamedParam2
hDstResource- [in]
Ein Handle für die Zielressource, in das aufgelöst werden soll. Diese Ressource muss als D3D10_USAGE_DEFAULT und einzelnes Beispiel erstellt worden sein.
unnamedParam3
DstSubresource [in]
Ein Index, der die Zielunterressource angibt, in die aufgelöst werden soll.
unnamedParam4
hSrcResource [in]
Ein Handle für die Quellressource, aus der sie aufgelöst werden soll.
unnamedParam5
SrcSubresource [in]
Ein Index, der die Quellunterressource angibt, aus der aufgelöst werden soll.
unnamedParam6
ResolveFormat- [in]
Ein DXGI_FORMAT typisierter Wert, der angibt, wie der Inhalt der aufgelösten Ressource interpretiert wird.
Rückgabewert
Nichts
Bemerkungen
Der Treiber kann die pfnSetErrorCb Rückruffunktion verwenden, um einen Fehlercode festzulegen.
Der Algorithmus zum Auflösen mehrerer Beispiele zu einem Pixel hängt von der Implementierung ab.
Der Auflösungsvorgang teilt ähnliche Einschränkungen wie Kopiervorgänge, die in Aufrufen der ResourceCopy- und ResourceCopyRegion--Funktionen auftreten. Das heißt, Quell- und Zielressourcen müssen denselben Typ aufweisen (z. B. Texture2D), und es können keine Dehnungs- oder Formatkonvertierungen auftreten. Der Treiber kann nur eine ganze Unterressource auflösen; Daher müssen sowohl die Quell- als auch die Zielunterressourcen in Dimensionen gleich sein. Aufgrund von typlosen Ressourcen können die folgenden Interaktionen entweder mit dem Quell- oder Zielressourcenformat vorhanden sein:
- Wenn jede Ressource vorstrukturiert und typiert ist, müssen beide Ressourcen denselben Formattyp aufweisen, und dieser Formattyp muss mit dem Formattyp übereinstimmen, der im Parameter ResolveFormat übergeben wurde (z. B. alle R32_FLOAT).
- Wenn eine Ressource vorstrukturiert und typlos ist, muss das Format der vorstrukturierten Und-Typ-Ressource mit dem typlosen Format kompatibel sein, und der Formattyp, der im Parameter ResolveFormat übergeben wurde, muss mit dem vorstrukturierten Plus-Typ-Format übereinstimmen (z. B. wenn das Quellformat R32_TYPELESS ist, und das Zielformat und ResolveFormat R32_FLOAT).
- Wenn beide Ressourcen vorstrukturiert und typlos sind, müssen sie gleich formatiert sein, und der Formattyp, der im parameter ResolveFormat übergeben wurde, kann ein beliebiges Format sein, das mit dem typlosen Format kompatibel ist. (Wenn z. B. das Quell- und Zielformat R32_TYPELESS ist und ResolveFormat- R32_FLOAT oder R32_UINT ist).
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Desktop |
| Header- | d3d10umddi.h (include D3d10umddi.h) |