функция обратного вызова PFND3DDDI_CREATECONTEXTCB (d3dumddi.h)
Функция обратного вызова среды выполнения Direct3D pfnCreateContextCb создает контекст.
Синтаксис
PFND3DDDI_CREATECONTEXTCB Pfnd3dddiCreatecontextcb;
HRESULT Pfnd3dddiCreatecontextcb(
HANDLE hDevice,
D3DDDICB_CREATECONTEXT *unnamedParam2
)
{...}
Параметры
hDevice
[in] Дескриптор устройства, для которого создается контекст.
unnamedParam2
[in/out] Указатель на структуру D3DDDICB_CREATECONTEXT, которую драйвер заполняет необходимыми сведениями для создания контекста. Эта структура включает такие сведения, как порядковый номер узла, сходство обработчиков и флаги, определяющие поведение и возможности создаваемого контекста. После успешного завершения среда выполнения обновляет эту структуру с информацией о только что созданном контексте.
Возвращаемое значение
pfnCreateContextCb возвращает HRESULT, чтобы указать успешность или сбой запроса на создание контекста. К общим возвращаемым значениям относятся:
| Возвращаемый код | Значение |
|---|---|
| S_OK | Контекст был успешно создан. |
| E_OUTOFMEMORY | Для создания контекста недостаточно памяти. |
| E_INVALIDARG | Один или несколько указанных аргументов недопустимы. |
Замечания
Драйвер отображения в пользовательском режиме (UMD) должен явно вызывать pfnCreateContextC b из своей реализации CreateDevice, чтобы создать контекст GPU, связанный с устройством. Контексты GPU — это потоки выполнения GPU на только что созданном устройстве.
Контекст инкапсулирует состояние и буферы команд, которые GPU использует для выполнения операций отрисовки. UMD отвечает за управление жизненным циклом контекстов, которые он создает, включая их окончательное уничтожение для освобождения ресурсов.
Дополнительные сведения о создании устройства отрисовки см. в потоке операций windows Display Driver Model (WDDM).
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista (WDDM 1.0) |
| заголовка | d3dumddi.h |