PFNDDXGIDDI_PRESENTCB função de retorno de chamada (dxgiddi.h)

Artigo
02/29/2024

A função pfnPresentCbDXGI copia o conteúdo de uma alocação de origem para uma alocação de destino.

Sintaxe

PFNDDXGIDDI_PRESENTCB PfnddxgiddiPresentcb;

HRESULT PfnddxgiddiPresentcb(
  HANDLE hDevice,
  DXGIDDICB_PRESENT *unnamedParam2
)
{...}

Parâmetros

hDevice

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

unnamedParam2

[in] pPresentData é um ponteiro para uma estrutura de DXGIDDICB_PRESENT que descreve as alocações de origem e destino das quais o conteúdo é copiado de e para.

Retornar valor

pfnPresentCbDXGI retorna um dos seguintes valores:

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

Comentários

O membro pDXGIContext da estrutura DXGIDDICB_PRESENT para a qual o parâmetro pPresentData aponta é um mecanismo de comunicação opaco. O runtime passa esse contexto DXGI para o driver no membro pDXGIContext da estrutura DXGI_DDI_ARG_PRESENT quando o runtime chama a função PresentDXGI do driver. O driver deve copiar esse contexto DXGI inalterado para o membro pDXGIContext de DXGIDDICB_PRESENT quando o driver chamar pfnPresentCbDXGI.

O runtime do Direct3D restringe o conjunto de formatos que podem ser apresentados por meio de uma operação bitblt (transferência de bloco de bits). Para obter mais informações sobre as restrições, consulte a seção Comentários da página de referência BltDXGI .