Função NtGdiDdDestroySurface

  • Artigo

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

Destrói um objeto de superfície do Microsoft DirectDraw no modo kernel alocado anteriormente.

Sintaxe

DWORD APIENTRY NtGdiDdDestroySurface(
  _In_ HANDLE hSurface,
  _In_ BOOL   bRealDestroy
);

Parâmetros

hSurface [in]

Identificador para o objeto de superfície do modo kernel alocado anteriormente.

bRealDestroy [in]

Especifica como destruir a superfície. Pode ser um dos valores a seguir.

(TRUE)

Destrua a superfície e libere a memória de vídeo.

(FALSE)

Libere a memória do vídeo, mas deixe a superfície em um estado não inicializado.

Valor retornado

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

 

Comentários

É recomendável que os aplicativos usem as APIs DirectDraw e Direct3D para criar e destruir superfícies em vez dessa função.

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