PDD_FREEDRIVERMEMORY funzione di callback (ddrawint.h)

Articolo
02/26/2024

La funzione callback DdFreeDriverMemory libera la memoria di visualizzazione fuori schermo o non locale per soddisfare una nuova richiesta di allocazione.

Sintassi

PDD_FREEDRIVERMEMORY PddFreedrivermemory;

DWORD PddFreedrivermemory(
  PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}

Parametri

unnamedParam1

Punta a una struttura DD_FREEDRIVERMEMORYDATA che contiene i dettagli della richiesta gratuita.

Valore restituito

DdFreeDriverMemory restituisce uno dei codici di callback seguenti:

Commenti

Il driver deve implementare DdFreeDriverMemory quando ha DirectDraw gestire tutta la gestione della memoria schermo offscreen, incluse le allocazioni per DrvCreateDeviceBitmap. Le richieste DirectDraw per le allocazioni nella memoria offscreen devono sempre avere la precedenza sulle allocazioni delle bitmap del dispositivo GDI.

DirectDraw chiama DdFreeDriverMemory quando non ha memoria di visualizzazione insufficiente o non locale per allocare una superficie richiesta da un'applicazione. Il driver deve spostare una bitmap del dispositivo GDI dalla memoria fuori schermo alla memoria di sistema e quindi restituire immediatamente. Gli spostamenti bitmap possono essere eseguiti chiamando EngModifySurface.

DirectDraw chiamerà continuamente DdFreeDriverMemory fino a quando non è disponibile memoria offscreen sufficiente da cui allocare la superficie richiesta o finché il driver non restituisce DDERR_OUTOFMEMORY.