IDCompositionVisual::SetBitmapInterpolationMode-Methode (dcomp.h)

Legt die BitmapInterpolationMode-Eigenschaft fest, die den Modus für Microsoft DirectComposition angibt, der beim Interpolieren von Pixeln aus Bitmaps verwendet werden soll, die nicht auf der Achse ausgerichtet oder exakt skaliert sind.

Syntax

HRESULT SetBitmapInterpolationMode(
  [in] DCOMPOSITION_BITMAP_INTERPOLATION_MODE interpolationMode
);

Parameter

[in] interpolationMode

Typ: DCOMPOSITION_BITMAP_INTERPOLATION_MODE

Der zu verwendende Interpolationsmodus.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition-Fehlercodes .

Hinweise

Der Interpolationsmodus wirkt sich darauf aus, wie eine Bitmap zusammengesetzt wird, wenn sie transformiert wird, sodass es keine 1:1-Entsprechung zwischen Pixeln in der Bitmap und Pixeln auf dem Bildschirm gibt.

Standardmäßig erbt ein Visual den Interpolationsmodus des übergeordneten Visuals, das den Interpolationsmodus des übergeordneten Visuals erben kann usw. Ein Visual verwendet den Standardinterpolationsmodus, wenn diese Methode nie für das Visual aufgerufen wird oder wenn diese Methode mit DCOMPOSITION_BITMAP_INTERPOLATION_MODE_INHERIT aufgerufen wird. Wenn keine Visuals den Interpolationsmodus festlegen, ist der Standardwert für die gesamte visuelle Struktur die nächste benachbarte Interpolation, die die niedrigste visuelle Qualität, aber die höchste Leistung bietet.

Wenn der InterpolationMode-Parameter etwas anderes als DCOMPOSITION_BITMAP_INTERPOLATION_MODE_INHERIT ist, wird die Bitmap dieses Visuals mit dem angegebenen Interpolationsmodus zusammengesetzt, und dieser Modus wird zum neuen Standardmodus für die untergeordneten Elemente dieses Visuals. Das heißt, wenn der Interpolationsmodus der untergeordneten Elemente dieses Visuals unverändert oder explizit auf DCOMPOSITION_BITMAP_INTERPOLATION_MODE_INHERIT festgelegt ist, werden die Bitmaps der untergeordneten Visuals mithilfe des Interpolationsmodus dieses Visuals zusammengesetzt.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dcomp.h
Bibliothek	Dcomp.lib
DLL	Dcomp.dll

Weitere Informationen

IDCompositionVisual