PAGP_COMMIT_PHYSICAL fonction de rappel (videoagp.h)
La fonction AgpCommitPhysical mappe la mémoire système (physique) à la plage spécifiée d’adresses physiques décodables AGP.
Syntaxe
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Paramètres
[in] HwDeviceExtension
Pointeur vers l’extension de périphérique du pilote miniport.
[in] PhysicalReserveContext
Identifie une plage d’adresses physiques réservées. Le handle de contexte est obtenu à partir d’AgpReservePhysical.
[in] Pages
Spécifie le nombre de pages de mémoire système à valider.
[in] Offset
Spécifie le décalage de page auquel valider les pages. Le décalage est appliqué à la plage d’adresses physiques réservées associée à PhysicalReserveContext.
Valeur retournée
AgpCommitPhysical retourne TRUE si le mappage a réussi, et FALSE dans le cas contraire.
Remarques
Un pilote de miniport vidéo doit d’abord réserver des adresses physiques en appelant AgpReservePhysical avant d’appeler cette fonction.
N’appelez pas AgpCommitPhysical pour valider les adresses qui ont déjà été validées. Si la plage de pages spécifiée par PhysicalReserveContext, Pages et Offset inclut toutes les pages précédemment validées, AgpCommitPhysical peut échouer.
Les pilotes de miniport vidéo qui s’exécutent sur Microsoft Windows 2000 doivent toujours réserver et valider une plage physique dont la taille est un multiple de 64 kilo-octets. La réservation ou la validation d’une plage physique qui n’est pas un multiple de 64 kilo-octets peut entraîner le renvoi d’une adresse virtuelle non valide par AgpReserveVirtual ou AgpCommitVirtual .
Sur Windows XP et versions ultérieures, AgpCommitPhysical étend automatiquement la plage validée afin qu’elle soit un multiple de 64 kilo-octets.
Lorsqu’un pilote de miniport vidéo appelle AgpCommitPhysical, une partie de la plage d’adresses physique identifiée par PhysicalReserveContext est mappée à des pages verrouillées de mémoire physique. La partie mappée commence à décaler les pages dans la plage identifiée par PhysicalReserveContext. Le pilote de miniport vidéo peut accéder à la mémoire physique validée comme si elle était contiguë.
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 |