PAGP_COMMIT_PHYSICAL Rückruffunktion (videoagp.h)
Die AgpCommitPhysical-Funktion ordnet systeminternen (physischen) Arbeitsspeicher dem angegebenen Bereich von AGP-decodierbaren physischen Adressen zu.
Syntax
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Parameter
[in] HwDeviceExtension
Zeiger auf die Geräteerweiterung des Miniporttreibers.
[in] PhysicalReserveContext
Identifiziert einen reservierten physischen Adressbereich. Das Kontexthandle wird von AgpReservePhysical abgerufen.
[in] Pages
Gibt die Anzahl der Seiten des Systemspeichers an, die committet werden sollen.
[in] Offset
Gibt den Seitenoffset an, an dem die Seiten committet werden sollen. Der Offset wird auf den reservierten physischen Adressbereich angewendet, der PhysicalReserveContext zugeordnet ist.
Rückgabewert
AgpCommitPhysical gibt TRUE zurück, wenn die Zuordnung erfolgreich war, andernfalls FALSE .
Hinweise
Ein Video-Miniporttreiber muss zuerst physische Adressen reservieren, indem er AgpReservePhysical aufruft , bevor er diese Funktion aufruft.
Rufen Sie AgpCommitPhysical nicht auf, um Adressen zu committen, die bereits committet wurden. Wenn der seitenbereich, der durch PhysicalReserveContext, Pages und Offset angegeben wird, seiten enthält, die zuvor committet wurden, schlägt AgpCommitPhysical möglicherweise fehl.
Video-Miniporttreiber, die unter Microsoft Windows 2000 ausgeführt werden, sollten immer einen physischen Bereich reservieren und committen, dessen Größe ein Vielfaches von 64 KB beträgt. Das Reservieren oder Committen eines physischen Bereichs, der kein Vielfaches von 64 KB ist, kann dazu führen, dass AgpReserveVirtual oder AgpCommitVirtual eine ungültige virtuelle Adresse zurückgibt.
Unter Windows XP und höher erweitert AgpCommitPhysical automatisch den Commitbereich, sodass er ein Vielfaches von 64 KB beträgt.
Wenn ein Video-Miniporttreiber AgpCommitPhysical aufruft, wird ein Teil des physischen Adressbereichs, der von PhysicalReserveContext identifiziert wird, gesperrten Seiten des physischen Speichers zugeordnet. Der zugeordnete Teil beginnt Offsetseiten in den durch PhysicalReserveContext identifizierten Bereich. Der Video-Miniporttreiber kann auf den committeten physischen Speicher zugreifen, als wäre er zusammenhängend.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | videoagp.h (video.h einschließen) |
| IRQL | PASSIVE_LEVEL |