DCompositionCreateSurfaceHandle-Funktion (dcomp.h)

Erstellt ein neues Kompositionsoberflächenobjekt, das an eine Microsoft DirectX-Swapchain oder einen Swappuffer gebunden und einer visuellen Grafik 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ächesobjekt. Dabei kann es sich um einen der folgenden Werte handeln:

[in, optional] securityAttributes

Typ: SECURITY_ATTRIBUTES*

Enthält den Sicherheitsdeskriptor für das Kompositionsoberflächesobjekt und gibt an, ob das Handle des Kompositionsoberflächenobjekts vererbbar ist, 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 aktivieren, um das Handle zu erben.

[out] surfaceHandle

Typ: HANDLE*

Der Ziehpunkt des neuen Kompositionsoberflächesobjekts. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Typ: HRESULT-

Wenn die Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben. Eine Liste der Fehlercodes finden Sie unter DirectComposition Error Codes.

Anforderungen