DwmDxGetWindowSharedSurface-Funktion

Ruft die freigegebene DirectX-Oberfläche ab, die ein bestimmtes Fenster unterstützt. Diese Oberfläche kann in geschrieben werden, um den Inhalt des Fensters zu aktualisieren.

Syntax

HRESULT WINAPI DwmDxGetWindowSharedSurface(
  _In_     HWND        hwnd,
  _In_     LUID        luidAdapter,
  _In_opt_ HMONITOR    hmonitorAssociation,
  _In_     DWORD       dwFlags,
  _Inout_  DXGI_FORMAT *pfmtWindow,
  _Out_    HANDLE      *phDxSurface,
  _Out_    UINT64      *puiUpdateId
);

Parameter

hwnd

Ein HWND, der das zu aktualisierende Fenster angibt.

luidAdapter

Die LUID des Adapters, in dem sich die Oberfläche befinden soll.

hmonitorAssociation

Reserviert.

dwFlags

Dieser Parameter kann einer der folgenden Werte oder ggf. eine bitweise OR-Kombination aus mehreren Werten sein.

Wert Bedeutung
DWM _ _UMLEITUNGSFLAG _ WARTE
0
Bewirkt, dass die Funktion blockiert wird, bis eine vertikale Synchronisierung (VSync) seit dem letzten erfolgreichen Aufruf der Funktion vergangen ist.
DWM _ UNTERSTÜTZUNG DES _ UMLEITUNGSFLAGS _ FÜR _ _ _ GDI _ SURFACE
0x10
Gibt an, dass die aufrufende Anwendung in der Lage ist, auf einer freigegebenen GDI-Oberfläche darzustellen.

pfmtWindow

Bei eingabe das gewünschte Format der Oberfläche. Bei der Ausgabe das tatsächliche Format der zurückgegebenen Oberfläche.

phDxSurface

Bei der Ausgabe das freigegebene Handle für die Oberfläche.

puiUpdateId

Bei der Ausgabe die ID des Updates.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S _ OK Der Aufruf war erfolgreich, und Sie sollten die Oberfläche aktualisieren. Achten Sie darauf, die Update-ID an D3DKMTRender zu übergeben (im PresentHistoryToken-Element der D3DKMT-RENDER-Struktur, _ wenn das Update übermittelt wird, und dann sollte DwmDxUpdateWindowSharedSurface mit der gleichen Update-ID aufgerufen werden. Beachten Sie, dass DwmDxUpdateWindowSharedSurface unabhängig davon aufgerufen werden sollte, ob die Oberfläche tatsächlich aktualisiert wurde oder nicht.
DWM _ S _ GDI _ REDIRECTION _ SURFACE Der Aufruf war erfolgreich, und Sie sollten die Oberfläche aktualisieren, indem Sie D3DKMTPresentaufrufen und das Modell des PresentHistoryToken-Elements auf D3DKMT _ PM _ REDIRECTED _ BLT festlegen und die Update-ID im Blt-Member der Union bereitstellen. Dieser Wert wird nur zurückgegeben, wenn DWM _ REDIRECTION _ FLAG SUPPORT PRESENT TO _ _ _ _ GDI _ SURFACE in dwFlags angegeben wurde.
DWM _ _ E-ADAPTER _ NICHT _ GEFUNDEN Der Wert von luidAdapter ist ungültig.
DWM _ E _ COMPOSITIONDISABLED DWM ist derzeit nicht aktiviert, und die Anwendung muss eine andere Möglichkeit bieten.

Hinweise

Diese API ist für die Implementierung eines Grafiktreibers oder einer Runtime vorgesehen. Eine Anwendung ruft diese Methode möglicherweise nicht auf. Diese Dokumentation gilt nur für Windows 7, und es ist nicht garantiert, dass diese API in anderen Versionen von Windows vorhanden ist oder sich auf ähnliche Weise verhält. Diese Funktion ist in keinem Header oder in einer statischen Linkbibliothek vorhanden und befindet sich unter der Ordnungszahl 100 in dwmapi.dll.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) nur Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server) Nicht unterstützt
Ende des Supports (Client) Windows 7
Header N/V
DLL Dwmapi.dll