Função NtGdiDdDestroySurface
[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 |
|---|---|
|
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. |
|
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 |
|
Confira também