Метод IDXGIResource1::CreateSubresourceSurface (dxgi1_2.h)

  • Статья

Создает объект поверхности подресурса.

Синтаксис

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

Параметры

index

Индекс объекта поверхности подресурсов для перечисления.

[out] ppSurface

Адрес указателя на интерфейс IDXGISurface2 , представляющий созданный объект поверхности подресурсов в позиции, указанной параметром индекса .

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

В случае успешного выполнения возвращает S_OK; в противном случае возвращает одно из следующих значений:

  • DXGI_ERROR_INVALID_CALL , если индекс выходит за пределы диапазона или подресурс не является допустимой поверхностью.
  • E_OUTOFMEMORY, если недостаточно памяти для создания объекта поверхности подресурсов.
Подресурс является допустимой поверхностью, если исходный ресурс был бы допустимой поверхностью, если размер массива был равен 1.

Комментарии

Объекты поверхности подресурсов реализуют интерфейс IDXGISurface2 , который наследуется от IDXGISurface1 и косвенно IDXGISurface. Таким образом, методы взаимодействия с GDI IDXGISurface1 работают, если исходный объект интерфейса ресурсов был создан с флагом взаимодействия GDI (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface создает поверхность подресурсов, основанную на интерфейсе ресурсов, в котором вызывается CreateSubresourceSurface . Например, если исходный объект интерфейса ресурсов является двухd текстурой, созданная подресурсная поверхность также является двухd текстурой.

CreateSubresourceSurface можно использовать для создания частей стереоресурса, чтобы использовать Direct2D в левой или правой части стереоресурса.

Требования

Требование Значение
Минимальная версия клиента Windows 8 и обновление платформы для Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2012 и обновление платформы для Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header dxgi1_2.h
Библиотека Dxgi.lib

См. также раздел

IDXGIResource1