fonction de rappel PAGP_FREE_VIRTUAL (videoagp.h)
La fonction AgpFreeVirt ual 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ée. Ce handle de contexte a été obtenu à partir de AgpReserveVirtual.
[in] Pages
Spécifie le nombre de pages de mémoire virtuelle que le pilote de port vidéo doit annuler le mappage.
[in] Offset
Spécifie le décalage de page dans la plage d’adresses virtuelle réservée identifiée par VirtualReserveContext qui indique l’adresse de base réelle à laquelle annuler le mappage de la mémoire virtuelle.
Valeur de retour
Aucun
Remarques
Lorsqu’un pilote miniport appelle AgpFreeVirtual, Pages pages d’adresses virtuelles non mappées. La plage non mappée commence pages Offset dans la plage associée à VirtualReserveContext. Le pilote miniport doit spécifier que le décalage exact et le nombre de pages sont libérés tel qu’ils ont été validés dans 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 pour AgpReserveVirtual. Si AgpReserveVirtual échoue (retourne NULL), vous ne devez pas appeler AgpCommitVirtual ou AgpFreeVirtual.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows. |
| plateforme cible | Bureau |
| d’en-tête | videoagp.h (include Video.h) |
| IRQL | PASSIVE_LEVEL |