Device.Reset - метод

Статья
11/04/2008

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

Сбрасывает параметры представления для текущего устройства.

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

Синтаксис

'Декларация
Public Sub Reset ( _
    presentationParameters As PresentParameters _
)
'Применение
Dim instance As Device
Dim presentationParameters As PresentParameters

instance.Reset(presentationParameters)

public void Reset(
    PresentParameters presentationParameters
)

public:
void Reset(
    PresentParameters^ presentationParameters
)

public function Reset(
    presentationParameters : PresentParameters
)

Параметры

presentationParameters
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.PresentParameters
Структура PresentParameters, описывающая параметры нового представления. Это значение не может быть равно null.

Исключения

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

Заметки

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

Если вызов Reset завершается неудачей, устройство переводится в состояние "утрачено", на что указывает значение false, возвращаемое вызовом CheckCooperativeLevel, если только устройство уже не находится в состоянии "не перезагружено", на что указывает значение DeviceNotReset возвращенное в параметре hResult метода CheckCooperativeLevel.

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

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

Вызов Reset завершается неудачей, если выполнен в потоке, отличном от того, в котором создавалось перезагружаемое устройство.

При вызове Device, Reset и SwapChain можно задать для формата целевого буфера визуализации оконного режима значение "неизвестен". Это означает, что приложение не должно запрашивать текущий формат рабочего стола перед вызовом Device для оконного режима. Для полноэкранного режима необходимо задать формат заднего буфера. При установке BackBufferCount в 0 создается один задний буфер.

Если хотите перезагрузить более одного экранного адаптера в группе, передайте массив объектов PresentParameters, по одному для каждого дисплея в группе адаптеров.

Разрешения

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

Платформы

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

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