Função NtGdiDdCreateSurfaceEx

Artigo
06/13/2023

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o DirectDraw e o 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.]

Cria uma superfície do Microsoft Direct3D de uma superfície do Microsoft DirectDraw e associa um valor de identificador solicitado a ela.

Sintaxe

DWORD APIENTRY NtGdiDdCreateSurfaceEx(
  _In_ HANDLE hDirectDraw,
  _In_ HANDLE hSurface,
  _In_ DWORD  dwSurfaceHandle
);

Parâmetros

hDirectDraw [in]: Manipule para o objeto DirectDraw criado pelo aplicativo.
hSurface [in]: Manipule para a superfície DirectDraw a ser criada para Direct3D. Esses identificadores são exclusivos em cada estrutura de DD_DIRECTDRAW_LOCAL diferente.
dwSurfaceHandle [in]: Manipule para uma estrutura DD_CREATESURFACEEXDATA que contém as informações necessárias para o driver criar a superfície.

Valor retornado

NtGdiDdCreateSurfaceEx 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 prosseguirá 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 for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou 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 prosseguirá 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 for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou 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