Device - конструктор (Int32, DeviceType, IntPtr, CreateFlags, PresentParameters)

Статья
11/04/2008

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

Инициализирует новый экземпляр структуры Device.

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

Синтаксис

'Декларация
Public Sub New ( _
    adapter As Integer, _
    deviceType As DeviceType, _
    renderWindowHandle As IntPtr, _
    behaviorFlags As CreateFlags, _
    presentationParameters As PresentParameters _
)
'Применение
Dim adapter As Integer
Dim deviceType As DeviceType
Dim renderWindowHandle As IntPtr
Dim behaviorFlags As CreateFlags
Dim presentationParameters As PresentParameters

Dim instance As New Device(adapter, _
    deviceType, renderWindowHandle, _
    behaviorFlags, presentationParameters)

public Device(
    int adapter,
    DeviceType deviceType,
    IntPtr renderWindowHandle,
    CreateFlags behaviorFlags,
    PresentParameters presentationParameters
)

public:
Device(
    int adapter, 
    DeviceType deviceType, 
    IntPtr renderWindowHandle, 
    CreateFlags behaviorFlags, 
    PresentParameters^ presentationParameters
)

public function Device(
    adapter : int, 
    deviceType : DeviceType, 
    renderWindowHandle : IntPtr, 
    behaviorFlags : CreateFlags, 
    presentationParameters : PresentParameters
)

Параметры

adapter
Тип: System.Int32
Порядковый номер, идентифицирующий физическое устройство, которое представляет данный объект. Используемым по умолчанию является устройство 0. Максимальное значение, которое может быть задано в этом параметре, на единицу меньше общего количества физических устройств.

deviceType
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.DeviceType
Член перечисления DeviceType, задающий требуемый тип устройства. Если устройство требуемого типа недоступно, вызов метода завершается ошибкой.

renderWindowHandle
Тип: System.IntPtr
Указатель на неуправляемую форму или форму, не являющуюся формой Windows, дескриптор окна. Заданное окно должно быть окном верхнего уровня. Значение Null не поддерживается.

behaviorFlags
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.CreateFlags
Сочетание одного или более параметров, управляющих созданием окна.

presentationParameters
Тип: Microsoft.WindowsMobile.DirectX.Direct3D.PresentParameters
Объект PresentParameters, описывающий параметры представления создаваемого устройства.

Заметки

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

Задние буферы, создаваемые как часть устройства, являются блокируемыми, только если задан LockableBackBuffer в PresentParameters. Многовыборочные задние буферы и поверхности глубины никогда не являются блокируемыми.

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

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

Выполнение метода Device завершается ошибкой, если предпринимается попытка создать устройство для окна с размерами 0x0.

Разрешения

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

Платформы

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

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