Device.SetRenderTarget - метод

Статья
11/04/2008

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

Задает для устройства новый буфер цвета.

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

Синтаксис

'Декларация
Public Sub SetRenderTarget ( _
    renderTarget As Surface, _
    newZStencil As Surface _
)
'Применение
Dim instance As Device
Dim renderTarget As Surface
Dim newZStencil As Surface

instance.SetRenderTarget(renderTarget, _
    newZStencil)

public void SetRenderTarget(
    Surface renderTarget,
    Surface newZStencil
)

public:
void SetRenderTarget(
    Surface^ renderTarget, 
    Surface^ newZStencil
)

public function SetRenderTarget(
    renderTarget : Surface, 
    newZStencil : Surface
)

Параметры

renderTarget
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Индекс Surface целевого буфера визуализации.

newZStencil
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.Surface
Surface нового буфера цвета. Если задано значение nullссылка null (Nothing в Visual Basic), буфер цвета для соответствующего renderTarget отключен. Устройства всегда должны быть связаны с буфером цвета.
Для новой поверхности целевого буфера визуализации должно быть задано как минимум значение Usage.

Исключения

Исключение	Условие
InvalidCallException	Вызов метода недопустим. Либо renderTarget содержит null и newZStencil = 0, либо renderTarget не равно null и целевой буфер визуализации недействителен.

Заметки

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

Тип MultiSampleType должен быть одним и тем же для целевого буфера визуализации и поверхности шаблона глубины.
Форматы целевого буфера визуализации и поверхности шаблона глубины должны быть совместимыми. Дополнительные сведения см. в описании CheckDepthStencilMatch.
Размер поверхности шаблона глубины должен быть больше размера целевого буфера визуализации или равен ему.

Эти ограничения проверяются только при использовании отладочной среды выполнения, при вызове любого из методов рисования Device.

Разрешения

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

Платформы

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 - пространство имен

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