IDCompositionVirtualSurface::Resize-Methode (dcomp.h)

Ändert die logische Größe dieses virtuellen Oberflächenobjekts.

Syntax

HRESULT Resize(
  [in] UINT width,
  [in] UINT height
);

Parameter

[in] width

Typ: UINT

Die neue Breite der virtuellen Oberfläche in Pixel. Die maximale Breite beträgt 16.777.216 Pixel.

[in] height

Typ: UINT

Die neue Höhe der virtuellen Oberfläche in Pixel. Die maximale Höhe beträgt 16.777.216 Pixel.

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

Wenn die Größe einer virtuellen Oberfläche geändert wird, wird ihr Inhalt bis zu den neuen Grenzen der Oberfläche beibehalten. Wenn die Oberfläche verkleinert wird, werden alle zuvor zugewiesenen Pixel verworfen, die außerhalb der neuen Breite oder Höhe liegen.

Diese Methode schlägt fehl, wenn IDCompositionSurface::BeginDraw für diese Bitmap ohne einen entsprechenden Aufruf von IDCompositionSurface::EndDraw aufgerufen wurde.

Diese Methode schlägt fehl, wenn die Breite oder Höhe 16.777.216 Pixel überschreitet.

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

IDCompositionDevice::CreateVirtualSurface

IDCompositionVirtualSurface

IDCompositionVirtualSurface::Trim