Device.CreateRenderTarget - метод

Статья
11/04/2008

Обновлен: Ноябрь 2007

Создает поверхность целевого буфера визуализации.

Пространство имен: Microsoft.WindowsMobile.DirectX.Direct3D
Сборка: Microsoft.WindowsMobile.DirectX (в Microsoft.WindowsMobile.DirectX.dll)

Синтаксис

'Декларация
Public Function CreateRenderTarget ( _
    width As Integer, _
    height As Integer, _
    format As Format, _
    multiSampleType As MultiSampleType, _
    lockable As Boolean _
) As Surface
'Применение
Dim instance As Device
Dim width As Integer
Dim height As Integer
Dim format As Format
Dim multiSampleType As MultiSampleType
Dim lockable As Boolean
Dim returnValue As Surface

returnValue = instance.CreateRenderTarget(width, _
    height, format, multiSampleType, _
    lockable)

public Surface CreateRenderTarget(
    int width,
    int height,
    Format format,
    MultiSampleType multiSampleType,
    bool lockable
)

public:
Surface^ CreateRenderTarget(
    int width, 
    int height, 
    Format format, 
    MultiSampleType multiSampleType, 
    bool lockable
)

public function CreateRenderTarget(
    width : int, 
    height : int, 
    format : Format, 
    multiSampleType : MultiSampleType, 
    lockable : boolean
) : Surface

Параметры

width
Тип: System.Int32
Ширина поверхности целевого буфера визуализации в точках.

height
Тип: System.Int32
Высота поверхности целевого буфера визуализации в точках.

format
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.Format
Член перечисления Format, задающий формат целевого буфера визуализации.

multiSampleType
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.MultiSampleType
Член перечисления MultiSampleType, задающий тип многовыборочного буфера. Параметр, задающий тип сглаживания для целевого буфера визуализации. Когда эта поверхность передается методу SetRenderTarget, ее многовыборочный тип должен быть таким же, как у свойства DepthStencilSurface шаблона глубины.

lockable
Тип: System.Boolean
Присвойте значение true, если целевые буферы визуализации являются блокируемыми; в противном случае — false. Обратите внимание, что блокируемые целевые буферы рендеринга снижают быстродействие на некоторых видах графического аппаратного обеспечения.

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

Тип: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Объект Surface.

Исключения

Исключение	Условие
NotAvailableException	Устройство не поддерживает запрашиваемый многовыборочный тип.
InvalidCallException	Вызов метода недопустим. Например, параметр может содержать недопустимое значение.
OutOfMemoryException	У Direct3D недостаточно памяти для выполнения этого вызова.

Заметки

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

Поверхности целевого буфера визуализации помещаются в класс памяти Pool. Создание блокируемых многовыборочных буферов визуализации не поддерживается.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

Платформы

Windows CE, Windows Mobile for Smartphone, Windows Mobile для карманных ПК

Среды .NET Framework и .NET Compact Framework поддерживают не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Сведения о версии

.NET Compact Framework

Поддерживается в версиях: 3.5, 2.0

См. также

Ссылки

Device Класс

Device - члены

Microsoft.WindowsMobile.DirectX.Direct3D - пространство имен

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