Função NtGdiDdSetOverlayPosition

[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.]

Define a posição de uma sobreposição.

Sintaxe

DWORD APIENTRY NtGdiDdSetOverlayPosition(
  _In_    HANDLE                     hSurfaceSource,
  _In_    HANDLE                     hSurfaceDestination,
  _Inout_ PDD_SETOVERLAYPOSITIONDATA puSetOverlayPositionData
);

Parâmetros

hSurfaceSource [in]

Manipule para uma estrutura DD_SURFACE_LOCAL que representa a superfície de sobreposição do DirectDraw.

hSurfaceDestination [in]

Ponteiro para uma estrutura DD_SURFACE_LOCAL que representa a superfície que está sendo sobreposta.

puSetOverlayPositionData [in, out]

Ponteiro para uma estrutura DD_SETOVERLAYPOSITIONDATA que contém as informações necessárias para definir a posição de sobreposição.

Valor retornado

NtGdiDdSetOverlayPosition 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.

 

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