PAGP_FREE_VIRTUAL fonction de rappel (videoagp.h)
La fonction AgpFreeVirtual libère la mémoire virtuelle validée par un appel précédent à AgpCommitVirtual.
Syntaxe
PAGP_FREE_VIRTUAL PagpFreeVirtual;
void PagpFreeVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID VirtualReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique du pilote miniport.
[in] VirtualReserveContext
Identifie une plage d’adresses virtuelles réservées. Ce handle de contexte a été obtenu à partir d’AgpReserveVirtual.
[in] Pages
Spécifie le nombre de pages de mémoire virtuelle que le pilote de port vidéo doit annuler.
[in] Offset
Spécifie le décalage de page dans la plage d’adresses virtuelles réservées identifiée par VirtualReserveContext qui indique l’adresse de base réelle à laquelle annuler le mappage de la mémoire virtuelle.
Valeur de retour
None
Remarques
Lorsqu’un pilote miniport appelle AgpFreeVirtual, les pages Pages d’adresses virtuelles sont non mappées. La plage non mappée commence à décaler les pages dans la plage associée à VirtualReserveContext. Le pilote miniport doit spécifier que le décalage exact et le nombre de pages doivent être libérés tels qu’ils ont été validés lors d’un appel antérieur à AgpCommitVirtual.
Un appel à AgpFreeVirtual doit être associé à un appel précédent à AgpCommitVirtual, et cet appel à AgpCommitVirtual doit être précédé d’un appel réussi à AgpReserveVirtual. Si AgpReserveVirtual échoue (retourne NULL), vous ne devez pas appeler AgpCommitVirtual ou AgpFreeVirtual.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | videoagp.h (incluez Video.h) |
| IRQL | PASSIVE_LEVEL |