PAGP_COMMIT_PHYSICAL fonction de rappel (videoagp.h)
La AgpCommitPhysical fonction 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ée. Le handle de contexte est obtenu à partir de 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 physique réservée associée à PhysicalReserveContext.
Valeur de retour
AgpCommitPhysical retourne TRUE si le mappage a réussi et FALSE sinon.
Remarques
Un pilote 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, Pageset Offset inclut les pages précédemment validées, AgpCommitPhysical peut échouer.
Les pilotes 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 AgpReserveVirtual ou AgpCommitVirtual renvoyer une adresse virtuelle non valide.
Sur Windows XP et versions ultérieures, AgpCommitPhysical développe automatiquement la plage validée afin qu’elle soit un multiple de 64 kilo-octets.
Lorsqu’un pilote miniport vidéo appelle AgpCommitPhysical, une partie de la plage d’adresses physique identifiée par PhysicalReserveContext est mappée aux pages verrouillées de la mémoire physique. La partie mappée commence pages Offset dans la plage identifiée par PhysicalReserveContext. Le pilote miniport vidéo peut accéder à la mémoire physique validée comme si elle était contiguë.
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 |