DCompositionCreateSurfaceHandle-Funktion (dcomp.h)

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:

[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