Share via

PAGP_COMMIT_VIRTUAL回呼函式 (videoagp.h)

  • 發行項

AgpCommitVirtual 函式會將保留的虛擬記憶體對應至相關聯的 AGP 可譯碼實體地址範圍。

語法

PAGP_COMMIT_VIRTUAL PagpCommitVirtual;

PVOID PagpCommitVirtual(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID VirtualReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

參數

[in] HwDeviceExtension

迷你埠驅動程式裝置延伸模組的指標。

[in] VirtualReserveContext

識別保留的虛擬位址範圍。 內容句柄是從 AgpReserveVirtual 取得。

[in] Pages

指定要對應的虛擬記憶體頁數。

[in] Offset

指定要認可頁面的頁面位移。 位移會套用至 VirtualReserveContext 所識別的保留虛擬位址範圍。

傳回值

如果對應成功，AgpCommitVirtual 會傳回認可頁面基底的虛擬位址;否則會傳回 NULL。

備註

呼叫 AgpCommitVirtual 以認可一系列虛擬頁面之前，您必須執行下列動作：

完成這些項目之後，您可以呼叫 AgpCommitVirtual ，將保留虛擬頁面的一部分對應至 AgpCommitPhysical 已對應並鎖定的頁面。 如果實體地址的對應頁面尚未對應，您就不得嘗試對應虛擬地址的頁面。

在 Microsoft Windows 2000 上執行的視訊迷你埠驅動程序應該一律認可大小為 64 KB 的倍數的虛擬範圍。 如果您呼叫 AgpCommitVirtual 來認可不是 64 KB 倍的虛擬範圍，它可能會傳回無效的虛擬位址。

在 Windows XP 和更新版本上， AgpCommitVirtual 會自動展開認可的範圍，使其為 64 KB 的倍數。

當迷你埠驅動程式呼叫 AgpCommitVirtual 時， VirtualReserveContext 所識別的一部分虛擬位址範圍會對應至實體位址。 對應的部分會開始 位移 頁面到 VirtualReserveContext 所識別的虛擬位址範圍。

規格需求

需求 值
最低支援的用戶端 可在 Windows 2000 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 videoagp.h (包含 Video.h)
IRQL PASSIVE_LEVEL

另請參閱

AgpFreeVirtual

AgpReservePhysical

AgpReserveVirtual