DwmInvalidateIconicBitmaps-Funktion (dwmapi.h)

Artikel
08/23/2023

Wird von einer Anwendung aufgerufen, um anzugeben, dass alle zuvor bereitgestellten ikonischen Bitmaps aus einem Fenster , sowohl Miniaturansichten als auch Vorschaudarstellungen, aktualisiert werden sollten.

Syntax

HRESULT DwmInvalidateIconicBitmaps(
  [in] HWND hwnd
);

Parameter

[in] hwnd

Ein Handle für das Fenster oder die Registerkarte, deren Bitmaps durch diesen Aufruf ungültig werden. Dieses Fenster muss zum aufrufenden Prozess gehören.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Aufrufen dieser Funktion bewirkt, dass der Desktopfenster-Manager (DWM) seine aktuellen Bitmaps für das Fenster ungültig macht und neue Bitmaps aus dem Fenster anfordert, wenn sie als nächstes benötigt werden. DwmInvalidateIconicBitmaps sollte nicht häufig aufgerufen werden. Dies kann zu einer schlechten Leistung führen, wenn neue Bitmaps erstellt und abgerufen werden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwmapi.h
Bibliothek	Dwmapi.lib
DLL	Dwmapi.dll; Uxtheme.dll

Freigeben über