PFND3D10DDI_RESOURCERESOLVESUBRESOURCE Rückruffunktion (d3d10umddi.h)

  • Artikel

Die ResourceResolveSubresource-Funktion löst mehrere Beispiele in ein 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 die aufgelöst werden soll. Diese Ressource muss als D3D10_USAGE_DEFAULT und einzelne Stichprobe erstellt worden sein.

unnamedParam3

DstSubresource [in]

Ein Index, der die Zielunterquelle angibt, in die aufgelöst werden soll.

unnamedParam4

hSrcResource [in]

Ein Handle für die Quellressource, aus der aufgelöst werden soll.

unnamedParam5

SrcSubresource [in]

Ein Index, der die Quellunterquelle 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 werden soll.

Rückgabewert

Keine

Bemerkungen

Der Treiber kann die Rückruffunktion pfnSetErrorCb verwenden, um einen Fehlercode festzulegen.

Der Algorithmus zum Auflösen mehrerer Stichproben in ein Pixel hängt von der Implementierung ab.

Der Auflösungsvorgang hat ähnliche Einschränkungen wie Kopiervorgänge, die in Aufrufen der Funktionen ResourceCopy und ResourceCopyRegion auftreten. Das heißt, sowohl Quell- als auch Zielressourcen müssen denselben Typ aufweisen (z. B. Texture2D), und es können keine Dehnungs- oder Formatkonvertierungen erfolgen. Der Treiber kann nur eine ganze Unterquelle auflösen. daher müssen sowohl die Quell- als auch die Zielunterressourcen in den Dimensionen gleich sein. Aufgrund von typlosen Ressourcen können die folgenden Interaktionen entweder mit dem Quell- oder Zielressourcenformat bestehen:

  • Wenn jede Ressource vorstrukturiert und typisiert ist, müssen beide Ressourcen denselben Formattyp aufweisen, und dieser Formattyp muss mit dem Formattyp übereinstimmen, der im ResolveFormat-Parameter übergeben wurde (z. B. alle R32_FLOAT).
  • Wenn eine Ressource vorstrukturiert und typlos ist, muss das Format der vorstrukturierten-plus-typisierten Ressource mit dem typlosen Format kompatibel sein, und der Formattyp, der im ResolveFormat-Parameter übergeben wurde, muss mit dem vorstrukturierten-plus-typed-Format übereinstimmen (z. B. wenn das Quellformat R32_TYPELESS ist und das Zielformat und ResolveFormat R32_FLOAT sind).
  • Wenn beide Ressourcen vorstrukturiert und typlos sind, müssen sie identische Formate sein, und der Formattyp, der im ResolveFormat-Parameter übergeben wurde, kann ein beliebiges Format sein, das mit dem typlosen Format kompatibel ist. (Beispielsweise, wenn das Quell- und Zielformat R32_TYPELESS und ResolveFormat R32_FLOAT oder R32_UINT ist).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile d3d10umddi.h (einschließlich D3d10umddi.h)

Weitere Informationen

ResourceCopy

ResourceCopyRegion

pfnSetErrorCb