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

Статья
08/07/2023

Функция pfnPresentCb копирует содержимое из исходного выделения.

Синтаксис

PFND3DDDI_PRESENTCB Pfnd3dddiPresentcb;

HRESULT Pfnd3dddiPresentcb(
  HANDLE hDevice,
  D3DDDICB_PRESENT *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in]

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

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

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

Код возврата	Описание
S_OK	Содержимое успешно скопировано.
E_OUTOFMEMORY	Не удалось завершить pfnPresentCb из-за нехватки памяти.
E_INVALIDARG	Параметры были проверены и определены как неверные.

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

Драйвер отображения пользовательского режима задает элемент hContextструктуры D3DDDICB_PRESENT , на который указывает параметр pData , в контекст, созданный ранее путем вызова функции pfnCreateContextCb . Драйвер отображения пользовательского режима должен создать по крайней мере один контекст, когда среда выполнения Microsoft Direct3D вызывает функцию CreateDevice или CreateDevice(D3D10) драйвера для создания устройства. Среда выполнения Direct3D отправляет текущую операцию в созданный контекст.

Direct3D версии 11 Примечание. Дополнительные сведения о том, как драйвер вызывает pfnPresentCb, см. в разделе Изменения в Direct3D 10.

Примеры

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

    HRESULT hr=S_OK;
    // A color-fill request that does not have a source surface
    D3DDDICB_PRESENT    PresentCBData = {0};

    PresentCBData.hContext = m_sContexts[MULTI_ENGINE_NODE_3D].hContext;
    PresentCBData.hSrcAllocation = NULL;

    if (pPresent->hDstResource) {
        DWORD   dwDstSurf = ((DWORD)(DWORD_PTR)pPresent->hDstResource) + pPresent->DstSubResourceIndex;
        _ASSERT(dwDstSurf < m_RTbl.Size());
        m_RTbl[dwDstSurf].m_qwBatch = m_qwBatch;
        PresentCBData.hDstAllocation = R200GetSurfaceAllocHandle(m_pR200Ctx, dwDstSurf);
    }

    hr = m_d3dCallbacks.pfnPresentCb(m_hD3D, &PresentCBData);

    return hr;

Требования

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