PDD_SURFCB_DESTROYSURFACE função de retorno de chamada (ddrawint.h)
A função de retorno de chamada DdDestroySurface destrói uma superfície DirectDraw.
Sintaxe
PDD_SURFCB_DESTROYSURFACE PddSurfcbDestroysurface;
DWORD PddSurfcbDestroysurface(
PDD_DESTROYSURFACEDATA unnamedParam1
)
{...}
Parâmetros
unnamedParam1
Aponta para uma estrutura DD_DESTROYSURFACEDATA que contém as informações necessárias para destruir uma superfície.
Valor retornado
DdDestroySurface retorna um dos seguintes códigos de retorno de chamada:
Comentários
Se o DirectDraw fez a alocação de memória no momento da criação da superfície e o driver não estava envolvido na alocação, o DirectDraw não chama a função DdDestroySurface do driver para destruir a superfície.
Se o driver estiver executando o gerenciamento de memória de superfície em si, DdDestroySurface deverá liberar a memória da superfície e executar qualquer outra limpeza, como liberar dados privados armazenados nos membros dwReserved1 das estruturas DD_SURFACE_GLOBAL e DD_SURFACE_LOCAL .
Para uma superfície gerenciada pelo driver, se a superfície for persistente (ou seja, o sinalizador DDSCAPS2_DONOTPERSIST no membro dwCaps2 da estrutura DDSCAPS2 para a superfície não estiver definido), DdDestroySurface poderá ser chamado com a finalidade de remover a superfície da memória de vídeo. Nesse caso, o driver de exibição pode continuar a manter quaisquer dados privados nos membros dwReserved1 até que DdDestroySurface seja chamado para realmente destruir a superfície.
DdDestroySurface pode ser chamado com um PDEV desabilitado. O PDEV está desabilitado ou habilitado chamando a função DrvAssertMode do driver de exibição. Consulte Gerenciando PDEVs para obter mais informações.
Requisitos
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ddrawint.h (inclua Winddi.h) |