Функция D3DKMTCreateDCFromMemory (d3dkmthk.h)

  • Статья

Функция D3DKMTCreateDCFromMemory создает контекст отображения из указанного блока памяти.

Синтаксис

NTSTATUS D3DKMTCreateDCFromMemory(
  D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
);

Параметры

unnamedParam1

pData [in, out]

Указатель на структуру D3DKMT_CREATEDCFROMMEMORY , описывающую параметры для создания контекста отображения.

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

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

Код возврата Описание
STATUS_SUCCESS Контекст отображения успешно создан.
STATUS_INVALID_PARAMETER Параметры были проверены и определены как неверные.

Эта функция также может возвращать другие значения NTSTATUS .

Комментарии

Ядро управляет памятью, на которую ссылается контекст отображения, созданный функцией D3DKMTCreateDCFromMemory . Необходимо вызвать функцию D3DKMTDestoryDCFromMemory , чтобы освободить память, на которую ссылается контекст отображения. Любой другой подход к освобождению этой памяти завершится ошибкой.

Во время выполнения функции D3DKMTCreateDCFromMemory ядро блокирует и проверяет память, на которую указывает ссылка, выполняя непотобезопасную запись на каждую страницу в памяти. Никакие другие потоки в процессе не должны пытаться получить доступ к какой-либо части этой памяти в течение всего вызова D3DKMTCreateDCFromMemory ; В противном случае результаты будут неопределенными.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Целевая платформа Универсальное
Верхняя часть d3dkmthk.h (включая D3dkmthk.h)
Библиотека Gdi32.lib
DLL Gdi32.dll

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

D3DKMT_CREATEDCFROMMEMORY