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

Статья
02/23/2024

Функция pfnUnlockCb разблокирует выделение, которое было заблокировано вызовом функции pfnLockCb .

Синтаксис

PFND3DDDI_UNLOCKCB Pfnd3dddiUnlockcb;

HRESULT Pfnd3dddiUnlockcb(
  HANDLE hDevice,
  const D3DDDICB_UNLOCK *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in]

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

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

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

Код возврата	Описание
S_OK	Выделение было успешно разблокировано.
E_OUTOFMEMORY	pfnUnlockCb не удалось завершить из-за нехватки памяти. (Эта ошибка возникает, когда система находится в крайней ситуации с нехваткой памяти и недостаточно места для выделения массива страниц.)
E_INVALIDARG	Параметры были проверены и определены как неверные.

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

Драйвер отображения пользовательского режима должен вызвать функцию pfnUnlockCb , чтобы разблокировать выделение, которое ранее было заблокировано при вызове функции pfnLockCb . Если драйвер не вызывает pfnUnlockCb, теряется координация между средой выполнения Microsoft Direct3D, драйвером дисплея в пользовательском режиме и драйвером мини-порта дисплея.

Драйвер отображения пользовательского режима обычно вызывает pfnUnlockCb в ответ на вызов его функции Unlock или ResourceUnmap (или других вариантов ResourceUnmap , таких как DynamicIABufferUnmap), чтобы разблокировать ресурс или поверхность внутри ресурса. Перед возвращением из вызова Unlock или ResourceUnmap драйвер отображения пользовательского режима должен сначала сопоставить ресурс или поверхность с соответствующим выделением, а затем вызвать pfnUnlockCb , чтобы разблокировать выделение.

Драйвер отображения пользовательского режима также может вызывать pfnUnlockCb в ответ на вызов функции DestroyDevice или DestroyDevice(D3D10), чтобы освободить все ресурсы, выделенные для устройства. Во время существования устройства каждый вызов pfnLockCb для блокировки выделения должен быть связан с вызовом функции pfnUnlockCb , чтобы разблокировать выделение.

Драйвер отображения пользовательского режима может разблокировать несколько выделений в одном вызове pfnUnlockCb , задав член NumAllocations структуры D3DDDICB_UNLOCK количество выделений в массиве, заданное членом phAllocations D3DDDICB_UNLOCK.

Драйвер отображения пользовательского режима должен вызвать pfnUnlockCb , чтобы разблокировать все выделения, на которые ссылается поток команд, перед вызовом функции pfnRenderCb . В драйвере могут быть заблокированы выделения для поддержки, например флаг битового поля NoOverwrite . Если драйвер не разблокирует все эти выделения, может потребоваться диспетчер видеопамяти для размещения этих выделений в памяти AGP.

Драйвер отображения пользовательского режима не должен вызывать pfnUnlockCb , чтобы разблокировать выделение, которое может использовать приложение. Драйвер получает уведомление о том, что приложение больше не считывает или не записывает данные в выделение, когда драйвер получает вызов функции Unlock или ResourceUnmap для соответствующего ресурса.

Примеры

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

HRESULT CD3DContext::SyncEnginesUsingLock(VOID) {
    HRESULT hr;
    D3DDDICB_LOCK   lockCB;
    D3DDDICB_UNLOCK Unlock;

    memset(&lockCB, 0, sizeof(D3DDDICB_LOCK));
    lockCB.hAllocation = m_HandleUsedInLastSubmit;
    lockCB.PrivateDriverData = 0;                       
    hr = m_d3dCallbacks.pfnLockCb(m_hD3D, &lockCB);
    if (FAILED(hr)) {
        DBG_BREAK;
        return hr;
    }
    Unlock.NumAllocations = 1;
    Unlock.phAllocations = &m_HandleUsedInLastSubmit;
    m_d3dCallbacks.pfnUnlockCb(m_hD3D, &Unlock);   
    return hr;
}

Требования

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