PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB função de retorno de chamada (d3dumddi.h)

Artigo
02/06/2025

Copia o conteúdo de uma alocação de sobreposição multiplano de origem para uma alocação de destino. Pode ser chamado por drivers de exibição do WDDM (Modelo de Driver de Exibição) do Windows 1.3 ou posteriores.

Sintaxe

PFND3DDDI_PRESENTMULTIPLANEOVERLAYCB Pfnd3dddiPresentmultiplaneoverlaycb;

HRESULT Pfnd3dddiPresentmultiplaneoverlaycb(
  HANDLE hDevice,
  const D3DDDICB_PRESENTMULTIPLANEOVERLAY *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para um dispositivo de exibição (contexto gráfico).

unnamedParam2

pPresent [in]

Um ponteiro para uma estrutura de D3DDDICB_PRESENTMULTIPLANEOVERLAY que descreve as alocações de origem e de destino das quais o conteúdo é copiado de e para.

Valor de retorno

Retorna um destes valores:

Código de retorno	Descrição
S_OK	O conteúdo foi copiado com êxito.
E_OUTOFMEMORY	A função não pôde ser concluída devido à memória insuficiente.
E_INVALIDARG	Os parâmetros foram validados e determinados como incorretos.

Observações

O driver de exibição do modo de usuário deve chamar essa função somente depois de ter processado com êxito uma chamada pelo runtime da DXGI (Infraestrutura Gráfica do Microsoft DirectX) para a função pfnPresentMultiplaneOverlay (D3D).

Observação Quando o driver de exibição chama pfnPresentMultiPlaneOverlayCb (D3D), ele deve manter a mesma ordem de alocações no AllocationInfo membro da matriz da estrutura D3DDDICB_PRESENTMULTIPLANEOVERLAY como recebeu do runtime do Microsoft Direct3D quando o runtime chamado pfnPresentMultiplaneOverlay (D3D).

Por exemplo, o identificador de alocação no índice 1 de AllocationInfo deve representar o mesmo recurso que foi passado para o driver no índice 1 do pPresentPlanes membro da estrutura D3DDDIARG_PRESENTMULTIPLANEOVERLAY usada com pfnPresentMultiplaneOverlay (D3D).

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.1
servidor com suporte mínimo	Windows Server 2012 R2
da Plataforma de Destino	Área de trabalho
cabeçalho	d3dumddi.h (inclua D3dumddi.h)

Consulte também

D3DDDIARG_PRESENTMULTIPLANEOVERLAY

D3DDDICB_PRESENTMULTIPLANEOVERLAY

pfnPresentMultiplaneOverlay (D3D)

Partilhar via