функция обратного вызова DXGKDDI_CREATECONTEXT (d3dkmddi.h)
Функция dxgkDdiCreateContext создает контекст графической обработки (GPU).
Синтаксис
DXGKDDI_CREATECONTEXT DxgkddiCreatecontext;
NTSTATUS DxgkddiCreatecontext(
[in] IN_CONST_HANDLE hDevice,
[in/out] INOUT_PDXGKARG_CREATECONTEXT pCreateContext
)
{...}
Параметры
[in] hDevice
Дескриптор графического контекста устройства, в который создается новый контекст. Функция драйвера минипорта отображения DxgkDdiCreateDevice ранее предоставила этот дескриптор подсистеме ядра графики Microsoft DirectX в hDevice член структуры DXGKARG_CREATEDEVICE.
[in/out] pCreateContext
Указатель на структуру DXGKARG_CREATECONTEXT, содержащую сведения о создании контекста.
Возвращаемое значение
DxgkDdiCreateContext возвращает одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateContext успешно создал контекст. |
| STATUS_NO_MEMORY | DxgkDdiCreateContext не удалось выделить память, необходимую для завершения. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Драйвер мини-порта дисплея несовместим с драйвером отображения в пользовательском режиме, который инициировал вызов DxgkDdiCreateContext. |
Замечания
Драйвер использует контекст GPU для хранения коллекции состояния отрисовки.
Один процесс может создавать несколько контекстов на определенном устройстве.
Драйвер должен поддерживать произвольное количество контекстов. Единственная допустимая причина, по которой драйвер не мог создать контекст, заключается в том, что системная память не закончится.
Как правило, каждый контекст может ссылаться на любой ресурс, созданный ранее для устройства, которому принадлежит этот контекст.
DxgkDdiCreateContext должны быть доступны для страниц.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| целевая платформа | Настольный |
| заголовка | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |