PAGP_COMMIT_PHYSICAL videoagp.h) (回呼函式
AgpCommitPhysical 函式會將系統 (實體) 記憶體對應至指定的 AGP 可譯碼實體地址範圍。
語法
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
參數
[in] HwDeviceExtension
迷你埠驅動程式的裝置延伸模組指標。
[in] PhysicalReserveContext
識別保留的實體位址範圍。 內容句柄是從 AgpReservePhysical 取得。
[in] Pages
指定要認可的系統記憶體頁數。
[in] Offset
指定要認可頁面的頁面位移。 位移會套用至與 PhysicalReserveContext 相關聯的保留實體地址範圍。
傳回值
如果對應成功，AgpCommitPhysical 會傳回 TRUE，否則傳回 FALSE。
備註
視訊迷你埠驅動程序必須先呼叫 AgpReservePhysical 來保留實體位址，才能呼叫此函式。
請勿呼叫 AgpCommitPhysical 來認可已認可的位址。 如果 PhysicalReserveContext、 Pages 和 Offset 所指定的頁面範圍包含先前認可的任何頁面， AgpCommitPhysical 可能會失敗。
在 Microsoft Windows 2000 上執行的視訊迷你埠驅動程序應該一律保留並認可其大小為 64 KB 的倍數的實體範圍。 保留或認可不是 64 KB 倍的實體範圍可能會導致 AgpReserveVirtual 或 AgpCommitVirtual 傳回無效的虛擬位址。
在 Windows XP 和更新版本上， AgpCommitPhysical 會自動展開認可的範圍，使其為 64 KB 的倍數。
當視訊迷你埠驅動程式呼叫 AgpCommitPhysical 時， PhysicalReserveContext 所識別的一部分實體地址範圍會對應至鎖定的實體記憶體頁面。 對應的部分會開始 位移 頁面到 PhysicalReserveContext 所識別的範圍。 視訊迷你埠驅動程式可以存取已認可的實體記憶體，就像是連續的一樣。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。 |
| 目標平台 | 桌面 |
| 標頭 | videoagp.h (包含 Video.h) |
| IRQL | PASSIVE_LEVEL |