Função NtGdiDdUnattachSurface
[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.]
Remove um anexo, criado com NtGdiDdAttachSurface, entre dois objetos de superfície no modo kernel.
Sintaxe
VOID APIENTRY NtGdiDdUnattachSurface(
_In_ HANDLE hSurface,
_In_ HANDLE hSurfaceAttached
);
Parâmetros
-
hSurface [in]
-
O objeto de superfície do modo kernel que foi passado como o parâmetro hSurfaceFrom para NtGdiDdAttachSurface.
-
hSurfaceAttached [in]
-
O objeto de superfície do modo kernel que foi passado como o parâmetro hSurfaceTo para NtGdiDdAttachSurface
Valor retornado
NtGdiDdUnattachSurface 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 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. |
|
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. |
Comentários
É recomendável que os aplicativos usem a API DirectDraw, que lida com anexos de superfície de maneira mais alta.
Não é necessário chamar essa função porque o kernel destruirá automaticamente todos os anexos quando NtGdiDdDestroySurface for chamado.
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