PFND3DDDI_DEALLOCATE2CB função de retorno de chamada (d3dumddi.h)
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) |