PAGP_COMMIT_PHYSICAL Rückruffunktion (videoagp.h)
Die AgpCommitPhysical Function ordnet systeminternen (physischen) Speicher 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 AgpReservePhysicalabgerufen.
[in] Pages
Gibt die Anzahl der Seiten des zu übernehmenden Systemspeichers an.
[in] Offset
Gibt den Seitenoffset an, bei dem die Seiten commit ausgeführt werden sollen. Der Offset wird auf den reservierten physischen Adressbereich angewendet, der PhysicalReserveContextzugeordnet ist.
Rückgabewert
AgpCommitPhysical- gibt TRUE zurück, wenn die Zuordnung erfolgreich war, und andernfalls FALSE.
Bemerkungen
Ein Video-Miniporttreiber muss zuerst physische Adressen reservieren, indem AgpReservePhysical aufgerufen wird, bevor diese Funktion aufgerufen wird.
Rufen Sie nicht AgpCommitPhysical- auf, um Adressen zu übernehmen, die bereits zugesichert wurden. Wenn der Seitenbereich, der durch PhysicalReserveContext, Pagesangegeben wird, und Offset- alle Seiten enthält, die zuvor zugesichert wurden, kann AgpCommitPhysical- fehlschlagen.
Video-Miniporttreiber, die unter Microsoft Windows 2000 ausgeführt werden, sollten immer einen physischen Bereich reservieren und übernehmen, dessen Größe ein Vielfaches von 64 KB ist. Das Reservieren oder Commit eines physischen Bereichs, der kein Vielfaches von 64 KB ist, kann dazu führen, dass AgpReserveVirtual oder AgpCommitVirtual eine ungültige virtuelle Adresse zurückgeben.
Unter Windows XP und höher erweitert AgpCommitPhysical automatisch den zugesicherten Bereich, sodass es sich um ein Vielfaches von 64 KB handelt.
Wenn ein Video-Miniporttreiber AgpCommitPhysicalaufruft, wird ein Teil des physischen Adressbereichs, der durch PhysicalReserveContext- identifiziert wird, gesperrten Seiten des physischen Speichers zugeordnet. Der zugeordnete Teil beginnt Offset- Seiten in den Bereich, der durch PhysicalReserveContextidentifiziert wird. Der Video-Miniporttreiber kann auf zugesicherten physischen Speicher zugreifen, als wäre er zusammenhängend.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | videoagp.h (video.h einschließen) |
| IRQL- | PASSIVE_LEVEL |