Поделиться через

Функция DCompositionCreateSurfaceHandle (dcomp.h)

  • Статья

Создает новый объект поверхности композиции, который может быть привязан к цепочке буферов Microsoft DirectX или буферу буферов и связан с визуальным элементом.

Синтаксис

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

Параметры

[in] desiredAccess

Тип: DWORD

Запрошенный доступ к объекту поверхности композиции. Это может быть одно из следующих значений:

Ценность Значение
0x0000L
 Нет доступа.
COMPOSITIONOBJECT_READ
0x0001L
 Доступ на чтение. Только для внутреннего использования.
COMPOSITIONOBJECT_WRITE
0x0002L
 Доступ на запись. Только для внутреннего использования.
COMPOSITIONOBJECT_ALL_ACCESS
0x0003L
 Доступ на чтение и запись. Всегда указывайте этот флаг, за исключением дедупликации поверхности в другом процессе, в этом случае задайте desiredAccess значение 0.

[in, optional] securityAttributes

Тип: SECURITY_ATTRIBUTES*

Содержит дескриптор безопасности для объекта поверхности композиции и указывает, наследуется ли дескриптор поверхности композиции при создании дочернего процесса. Если этот параметр имеет значение NULL, объект поверхности композиции создается с атрибутами безопасности по умолчанию, предоставляющими доступ для чтения и записи к текущему процессу, но не разрешать дочерним процессам наследовать дескриптор.

[out] surfaceHandle

Тип: HANDLE*

Дескриптор нового объекта поверхности композиции. Этот параметр не должен иметь значение NULL.

Возвращаемое значение

Тип: HRESULT

Если функция выполнена успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT. См. коды ошибок DirectComposition для списка кодов ошибок.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8 [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2012 [только классические приложения]
целевая платформа Виндоус
заголовка dcomp.h
библиотеки Dcomp.lib
DLL Dcomp.dll