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

Artigo
02/29/2024

A função D3dDestroyDDLocal destrói todas as superfícies do Microsoft Direct3D criadas anteriormente pela função D3dCreateSurfaceEx que pertencem ao mesmo objeto local do Microsoft DirectDraw.

Sintaxe

PDD_DESTROYDDLOCAL PddDestroyddlocal;

DWORD PddDestroyddlocal(
  PDD_DESTROYDDLOCALDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura DDHAL_DESTROYDDLOCALDATA que contém as informações necessárias para o driver destruir as superfícies.

Retornar valor

D3dDestroyDDLocal retorna um dos seguintes códigos de retorno de chamada:

Comentários

Todos os drivers Direct3D devem dar suporte a D3dDestroyDDLocal.

O Direct3D chama D3dDestroyDDLocal quando o aplicativo indica que o contexto direct3D não é mais necessário e será destruído junto com todas as superfícies associadas a ele. A associação vem por meio do ponteiro para o objeto DirectDraw local. O driver deve liberar qualquer memória que o retorno de chamada D3dCreateSurfaceEx do driver tenha alocado para cada superfície, se necessário.

O driver não deve destruir as superfícies DirectDraw associadas a essas superfícies Direct3D. Essa é a responsabilidade do aplicativo.

O ponteiro para a estrutura DD_DIRECTDRAW_LOCAL que foi passada como o membro lpDDLcl da estrutura D3DHAL_CONTEXTCREATEDATA quando D3dContextCreate foi chamado é liberado pelo sistema operacional depois que D3dDestroyDDDLocal retorna.

D3dDestroyDDLocal pode ser chamado com um PDEV desabilitado. Um PDEV é desabilitado ou habilitado chamando a função DrvAssertMode do driver de exibição. Consulte Gerenciando PDEVs para obter mais informações.