Freigeben über

DCompositionCreateSurfaceHandle-Funktion (dcomp.h)

  • Artikel

Erstellt ein neues Kompositionsoberflächenobjekt, das an eine Microsoft DirectX-Swapchain oder einen Swappuffer gebunden und einem Visual zugeordnet werden kann.

Syntax

HRESULT DCompositionCreateSurfaceHandle(
  [in]           DWORD               desiredAccess,
  [in, optional] SECURITY_ATTRIBUTES *securityAttributes,
  [out]          HANDLE              *surfaceHandle
);

Parameter

[in] desiredAccess

Typ: DWORD

Der angeforderte Zugriff auf das Kompositionsoberflächenobjekt. Es kann sich um einen der folgenden Werte handeln:

Wert Bedeutung
0x0000L
 Kein Zugriff.
COMPOSITIONSURFACE_READ
0x0001L
 Lesezugriff. Nur zur internen Verwendung.
COMPOSITIONSURFACE_WRITE
0x0002L
 Schreibzugriff. Nur zur internen Verwendung.
COMPOSITIONSURFACE_ALL_ACCESS
0x0003L
 Lese-/Schreibzugriff. Geben Sie immer dieses Flag an, außer beim Duplizieren einer Oberfläche in einem anderen Prozess, in diesem Fall set desiredAccess auf 0.

[in, optional] securityAttributes

Typ: SECURITY_ATTRIBUTES*

Enthält den Sicherheitsdeskriptor für das Composition Surface-Objekt und gibt an, ob der Handle des Composition Surface-Objekts vererbt werden kann, wenn ein untergeordneter Prozess erstellt wird. Wenn dieser Parameter NULL ist, wird das Kompositionsoberflächenobjekt mit Standardsicherheitsattributen erstellt, die Lese- und Schreibzugriff auf den aktuellen Prozess gewähren, aber keine untergeordneten Prozesse zum Erben des Handle aktivieren.

[out] surfaceHandle

Typ: HANDLE*

Der Handle des neuen Kompositionsoberflächenobjekts. Dieser Parameter darf nicht NULL sein.

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 .

Anforderungen

Anforderung Wert
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