Partager via


PDD_FREEDRIVERMEMORY fonction de rappel (ddrawint.h)

La fonction de rappel DdFreeDriverMemory libère de la mémoire d’affichage hors écran ou non locale pour répondre à une nouvelle demande d’allocation.

Syntaxe

PDD_FREEDRIVERMEMORY PddFreedrivermemory;

DWORD PddFreedrivermemory(
  PDD_FREEDRIVERMEMORYDATA unnamedParam1
)
{...}

Paramètres

unnamedParam1

Pointe vers une structure DD_FREEDRIVERMEMORYDATA qui contient les détails de la demande gratuite.

Valeur retournée

DdFreeDriverMemory retourne l’un des codes de rappel suivants :

Remarques

Le pilote doit implémenter DdFreeDriverMemory quand DirectDraw gère toute la gestion de la mémoire d’affichage hors écran, y compris les allocations pour DrvCreateDeviceBitmap. Les demandes DirectDraw d’allocations dans la mémoire hors écran doivent toujours être prioritaires sur les allocations bitmap d’appareil GDI.

DirectDraw appelle DdFreeDriverMemory lorsqu’il ne dispose pas de suffisamment de mémoire d’affichage hors écran ou non locale pour allouer une surface demandée par une application. Le pilote doit déplacer une bitmap de périphérique GDI de la mémoire hors écran dans la mémoire système, puis revenir immédiatement. Les déplacements bitmap peuvent être effectués en appelant EngModifySurface.

DirectDraw appelle continuellement DdFreeDriverMemory jusqu’à ce qu’il y ait suffisamment de mémoire hors écran à partir de laquelle allouer la surface demandée ou jusqu’à ce que le pilote retourne DDERR_OUTOFMEMORY.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête ddrawint.h (incluez Winddi.h)

Voir aussi

DD_FREEDRIVERMEMORYDATA

DrvCreateDeviceBitmap

EngModifySurface

HeapVidMemAllocAligned