функция обратного вызова PFND3DDDI_UNLOCK (d3dumddi.h)
Функция разблокировки разблокирует ресурс или поверхность в ресурсе, ранее заблокированном функцией Блокировка.
Синтаксис
PFND3DDDI_UNLOCK Pfnd3dddiUnlock;
HRESULT Pfnd3dddiUnlock(
HANDLE hDevice,
const D3DDDIARG_UNLOCK *unnamedParam2
)
{...}
Параметры
hDevice
Дескриптор устройства отображения (графический контекст).
unnamedParam2
pData [in]
Указатель на структуру D3DDDIARG_UNLOCK, описывающую ресурс или поверхность в ресурсе для разблокировки.
Возвращаемое значение
Разблокировка возвращает одно из следующих значений:
| код возврата | описание |
|---|---|
| S_OK | Ресурс успешно разблокирован. |
| E_OUTOFMEMORY | Разблокировка не могла выделить необходимую память для завершения. |
| E_INVALIDARG | Ресурс, который D3DDDIARG_UNLOCK описывается, не был заблокирован предыдущим вызовом функции блокировки драйвера. |
Замечания
Эти комментарии аналогичны описанию в разделе "Примечания" на странице справки по блокировки.
Драйвер отображения в пользовательском режиме должен вызывать функцию среды выполнения Microsoft Direct3D pfnUnlockCb после вызова Разблокировки. В этом вызове pfnUnlockCb драйвер отображения пользовательского режима передает дескриптор выделения. Перед вызовом pfnUnlockCbдрайвер отображения в пользовательском режиме должен сначала сопоставить поверхность с соответствующим выделением.
Среда выполнения вызывает функцию разблокировки драйвера в пользовательском режиме для разблокировки предварительно разблокированных системных поверхностей памяти. Среда выполнения задает флаг NotifyOnly битового поля в элементе Flags структуры D3DDDIARG_UNLOCK, на которую указывает pData, чтобы различать вызовы разблокировки, которые разблокируют предварительно выделенное системное память от других вызовов Разблокировки. Если функция блокировки драйвера в пользовательском режиме, вызываемая pfnLockCb для блокировки выделения памяти системы, соответствующей поверхности, она также должна вызывать pfnUnlockCb. Не вызывая pfnUnlockCb останавливает координацию между средой выполнения, драйвером отображения в пользовательском режиме и драйвером мини-порта дисплея.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционных систем Windows. |
| целевая платформа | Всеобщий |
| заголовка | d3dumddi.h (include D3dumddi.h) |