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

Статья
02/23/2024

Функция Rename сообщает драйверу отображения пользовательского режима о необходимости использовать переименованное выделение, возвращенное ранее функцией LockAsync для указанного ресурса.

Синтаксис

PFND3DDDI_RENAME Pfnd3dddiRename;

HRESULT Pfnd3dddiRename(
  HANDLE hDevice,
  const D3DDDIARG_RENAME *unnamedParam2
)
{...}

Параметры

hDevice

Дескриптор для устройства отображения (то есть графического контекста).

unnamedParam2

pData [in]

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

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

При переименовании возвращается одно из следующих значений:

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

На компьютерах с несколькими процессорами среда выполнения Microsoft Direct3D вызывает функцию Rename драйвера отображения пользовательского режима из рабочего потока, а не из потока приложения main. Среда выполнения вызывает Rename(Не более одного раза) для каждого успешного вызова функции LockAsync драйвера с флагом битового поля , установленным в элементе Flagsструктуры D3DDDIARG_LOCKASYNC , на которую указывает параметр pDatalockAsync .

Переименование сообщает драйверу начать использовать переименованное выделение, указанное членом hCookieструктуры D3DDDIARG_RENAME , на которую указывает параметр pDataэлемента Rename . Дескриптор hCookie ранее возвращался функцией LockAsync, если для заблокированного ресурса был установлен флаг битового поля "Отменить".

После успешного возврата rename (с S_OK) драйвер отображения пользовательского режима должен использовать выделение, указанное hCookie для всех операций отрисовки, ссылающихся на ресурс, указанный членами hResource и SubResourceIndex D3DDDIARG_RENAME.

Требования

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

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