функция обратного вызова PFND3DDDI_CREATEDEVICE (d3dumddi.h)

  • Статья

Функция CreateDevice создает графический контекст, на который ссылается в последующих вызовах.

Синтаксис

PFND3DDDI_CREATEDEVICE Pfnd3dddiCreatedevice;

HRESULT Pfnd3dddiCreatedevice(
  HANDLE hAdapter,
  D3DDDIARG_CREATEDEVICE *unnamedParam2
)
{...}

Параметры

hAdapter

Дескриптор, идентифицирующий графический адаптер.

unnamedParam2

pCreateData [in, out]

Указатель на структуру D3DDDIARG_CREATEDEVICE . На входных данных эта структура содержит сведения, которые может использовать драйвер. В выходных данных драйвер указывает сведения в структуре, которую может использовать среда выполнения Microsoft Direct3D.

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

CreateDevice возвращает одно из следующих значений:

Код возврата Описание
S_OK Контекст графики успешно создан.
E_OUTOFMEMORY CreateDevice не удалось выделить память, необходимую для ее завершения.

Комментарии

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

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

Когда среда выполнения Direct3D вызывает CreateDevice для создания устройства, среда выполнения не создает поток контекста выполнения графического процессора (GPU) по умолчанию для устройства. Драйвер должен явно вызвать функцию pfnCreateContextCb , чтобы создать один или несколько контекстов по мере необходимости.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Персональный компьютер
Верхняя часть d3dumddi.h (включая D3dumddi.h)

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

D3DDDIARG_CREATEDEVICE

D3DDDI_ADAPTERFUNCS

DestroyDevice