Função NtGdiDdFlip

Artigo
06/13/2023

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]

Faz com que a memória da superfície associada às superfícies de destino e atuais seja trocada.

Sintaxe

DWORD APIENTRY NtGdiDdFlip(
  _In_    HANDLE       hSurfaceCurrent,
  _In_    HANDLE       hSurfaceTarget,
  _In_    HANDLE       hSurfaceCurrentLeft,
  _In_    HANDLE       hSurfaceTargetLeft,
  _Inout_ PDD_FLIPDATA puFlipData
);

Parâmetros

hSurfaceCurrent [in]: Manipule para a estrutura DD_SURFACE_LOCAL que descreve a superfície atual.
hSurfaceTarget [in]: Identificador para a estrutura DD_SURFACE_LOCAL que descreve a superfície de destino; ou seja, a superfície para a qual o driver deve inverter.
hSurfaceCurrentLeft [in]: Manipule para a estrutura DD_SURFACE_LOCAL que descreve a superfície esquerda atual.
hSurfaceTargetLeft [in]: Manipule para a estrutura DD_SURFACE_LOCAL que descreve a superfície de destino à esquerda para a qual inverter.
puFlipData [in, out]: Ponteiro para uma estrutura DD_FLIPDATA que contém as informações necessárias para executar a inversão.

Valor retornado

NtGdiDdFlip retorna um dos seguintes códigos de retorno de chamada.

Código de retorno	Descrição
DDHAL_DRIVER_HANDLED	O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D continuará com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.
DDHAL_DRIVER_NOTHANDLED	O driver não tem comentários sobre a operação solicitada. Se o driver precisar ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, o DirectDraw ou o Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D.

Código de retorno

Descrição

DDHAL_DRIVER_HANDLED

O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D continuará com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.

DDHAL_DRIVER_NOTHANDLED

O driver não tem comentários sobre a operação solicitada. Se o driver precisar ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, o DirectDraw ou o Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Ntgdi.h

Confira também

Suporte ao cliente de baixo nível de gráficos

Compartilhar via