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 |
|---|---|
|
Bewirkt, dass die Funktion blockiert wird, bis eine vertikale Synchronisierung (VSync) seit dem letzten erfolgreichen Aufruf der Funktion vergangen ist. |
|
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 |