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

  • Artigo

A função de retorno de chamada do modo de usuário pfnDeallocate2Cb libera alocações para um objeto de recurso no modo kernel se o objeto de recurso foi criado.

pfnDeallocate2Cb é um substituto para pfnDeallocateCb que tem um membro Flags adicional. Quando Sinalizadores são definidos como todos os zeros, o comportamento é equivalente a pfnDeallocateCb.

Sintaxe

PFND3DDDI_DEALLOCATE2CB Pfnd3dddiDeallocate2cb;

HRESULT Pfnd3dddiDeallocate2cb(
  HANDLE hDevice,
  const D3DDDICB_DEALLOCATE2 *unnamedParam2
)
{...}

Parâmetros

hDevice

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

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDICB_DEALLOCATE2 que descreve o recurso a ser liberado.

Retornar valor

Código de retorno Descrição
S_OK A memória foi liberada com êxito.
E_INVALIDARG Os parâmetros foram validados e determinados como incorretos.

Essa função também pode retornar outros valores HRESULT.

Comentários

Quando uma solicitação de destruição de alocação é recebida, o VidMm pressupõe, por padrão, que os comandos enfileirados antes da solicitação de destruição podem acessar a alocação que está sendo destruída e adia a operação de destruição até que os comandos enfileirados sejam concluídos. Se o UMD (driver de modo de usuário) souber que os comandos pendentes não acessam a alocação que está sendo destruída, ele poderá instruir o VidMm a não aguardar até que os comandos pendentes sejam concluídos definindo o sinalizador AssumeNotInUse como TRUE ao chamar pfnDeallocate2Cb.

Se um aplicativo ou UMD quiser garantir que a memória de alocação seja recuperada antes do retorno da chamada pfnDeallocate2Cb (por exemplo, para minimizar o pico de uso de memória se a superfície estiver sendo recriada), ela deverá definir o sinalizador SynchronousDestroy .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10
Servidor mínimo com suporte Windows Server 2016
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDICB_DEALLOCATE2

pfnDeallocateCb