функция обратного вызова PFND3DDDI_RENAME (d3dumddi.h)
Функция 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) |