PDD_SURFCB_DESTROYSURFACE função de retorno de chamada (ddrawint.h)

Artigo
08/23/2023

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.