Partilhar via


PFND3DDDI_DESTROYRESOURCE função de retorno de chamada (d3dumddi.h)

A função DestroyResource libera um recurso especificado.

Sintaxe

PFND3DDDI_DESTROYRESOURCE Pfnd3dddiDestroyresource;

HRESULT Pfnd3dddiDestroyresource(
  HANDLE hDevice,
  HANDLE unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico) usado para destruir o recurso.

unnamedParam2

hResource [in]

Um identificador para o recurso que a função CreateResource ou OpenResource criou.

Valor de retorno

DestroyResource retorna S_OK ou um resultado de erro apropriado é que o recurso não foi liberado.

Observações

Depois que o runtime do Microsoft Direct3D chama a função destroyResource do driver de exibição do modo de usuário, o driver de exibição no modo de usuário deve primeiro liberar todos os comandos em lote que dependem do recurso que está sendo destruído chamando a função pfnRenderCb do do runtime. Em seguida, o driver deve chamar a função pfnDeallocateCb do runtime para destruir alocações associadas ao recurso.

Observação A função DestroyResource do driver não é necessária para chamar pfnDeallocateCb antes de retornar; em vez disso, o driver pode adiar a destruição da alocação.
 
Observação Uma chamada DestroyResource separada não é feita para cada superfície que faz parte do recurso. Portanto, se um grupo de superfícies for criado atomicamente, o grupo será sempre destruído atomicamente também.
 
Para obter mais informações sobre como criar e destruir recursos, consulte Manipulandode Criação e Destruição de Recursos.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino Área de trabalho
cabeçalho d3dumddi.h (inclua D3dumddi.h)

Consulte também

CreateResource

D3DDDI_DEVICEFUNCS

OpenResource

pfnDeallocateCb

pfnRenderCb