PDD_DESTROYDDLOCAL função de retorno de chamada (ddrawint.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ddrawint.h (inclua Winddi.h) |