PFND3DDDI_PRESENTCB función de devolución de llamada (d3dumddi.h)

Artículo
02/23/2024

La función pfnPresentCb copia el contenido de una asignación de origen.

Sintaxis

PFND3DDDI_PRESENTCB Pfnd3dddiPresentcb;

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

Parámetros

hDevice

Identificador de un dispositivo de visualización (contexto de gráficos).

unnamedParam2

pData [in]

Puntero a una estructura de D3DDDICB_PRESENT que describe la asignación de origen de la que se copia el contenido.

Valor devuelto

pfnPresentCb devuelve uno de los siguientes valores:

Código devuelto	Descripción
S_OK	El contenido se copió correctamente.
E_OUTOFMEMORY	pfnPresentCb no se pudo completar debido a memoria insuficiente.
E_INVALIDARG	Los parámetros se validaron y determinaron que son incorrectos.

Esta función también puede devolver otros valores HRESULT.

Comentarios

El controlador de visualización en modo de usuario establece el miembro hContext de la estructura D3DDDICB_PRESENT a la que apunta el parámetro pData a un contexto que creó anteriormente mediante una llamada a la función pfnCreateContextCb . El controlador de pantalla en modo de usuario debe crear al menos un contexto cuando el entorno de ejecución de Microsoft Direct3D llama a la función CreateDevice o CreateDevice(D3D10) del controlador para crear un dispositivo. El tiempo de ejecución de Direct3D envía la operación presente a un contexto creado.

Nota de Direct3D versión 11: Para obtener más información sobre cómo el controlador llama a pfnPresentCb, consulte Cambios de Direct3D 10.

Ejemplos

En el ejemplo de código siguiente se muestra cómo rellenar en color una superficie de destino.

    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;

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino	Escritorio
Encabezado	d3dumddi.h (incluya D3dumddi.h)