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

Artigo
02/26/2024

A função de retorno de chamada DdFreeDriverMemory libera memória de exibição fora da tela ou não local para atender a uma nova solicitação de alocação.

Sintaxe

PDD_FREEDRIVERMEMORY PddFreedrivermemory;

DWORD PddFreedrivermemory(
  PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}

Parâmetros

unnamedParam1

Aponta para uma estrutura de DD_FREEDRIVERMEMORYDATA que contém os detalhes da solicitação gratuita.

Retornar valor

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

Comentários

O driver deve implementar DdFreeDriverMemory quando tiver o DirectDraw gerenciando todo o gerenciamento de memória de exibição fora da tela, incluindo alocações para DrvCreateDeviceBitmap. As solicitações do DirectDraw para alocações na memória fora da tela sempre devem ter precedência sobre alocações de bitmap do dispositivo GDI.

O DirectDraw chama DdFreeDriverMemory quando não tem memória de exibição offscreen ou não local suficiente para alocar uma superfície solicitada por um aplicativo. O driver deve mover um bitmap de dispositivo GDI da memória offscreen para a memória do sistema e, em seguida, retornar imediatamente. As movimentações de bitmap podem ser realizadas chamando EngModifySurface.

O DirectDraw chamará continuamente DdFreeDriverMemory até que haja memória offscreen suficiente para alocar a superfície solicitada ou até que o driver retorne DDERR_OUTOFMEMORY.