Share via

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

另請參閱

AgpCommitVirtual

AgpReservePhysical

AgpReserveVirtual