PAGP_RESERVE_PHYSICAL回呼函式 (videoagp.h)

AgpReservePhysical 函式會在 AGP 控制器可以響應的系統總線上保留一系列實體位址。

語法

PAGP_RESERVE_PHYSICAL PagpReservePhysical;

PHYSICAL_ADDRESS PagpReservePhysical(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN ULONG Pages,
  [in]  IN VIDEO_PORT_CACHE_TYPE Caching,
  [out] OUT PVOID *PhysicalReserveContext
)
{...}

參數

[in] HwDeviceExtension

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

[in] Pages

指定視訊埠驅動程式應保留的頁面數目。

[in] Caching

指定系統應該使用的快取類型。 此參數可以設定為下列其中一個值。

ReplTest1	意義
VpNonCached	系統不應該快取位址範圍。
VpWriteCombined	系統應該使用寫入合併 (WC) 快取。 如需 WC 快取的相關信息，請參閱 Video Miniport Drivers 網站中的寫入合併記憶體 一文。
VpCached	系統應該使用一般快取。

[out] PhysicalReserveContext

指定視訊埠驅動程式寫入內容句柄的位置，以識別保留的實體地址空間。

傳回值

如果成功，AgpReservePhysical 會傳回保留實體位址範圍的基位址;否則會傳回 NULL。

備註

在 Microsoft Windows 2000 上執行的視訊迷你埠驅動程序應該一律保留大小為 64 KB 的倍數的範圍。 保留不是 64 KB 倍的範圍可能會導致 AgpReserveVirtual 或 AgpCommitVirtual 傳回無效的虛擬位址。

在 Microsoft Windows XP 和更新版本上， AgpReservePhysical 會自動將要求的範圍擴充為 64 KB 的倍數。

成功傳回時，AGP 控制器可以回應總線上的保留實體位址範圍。 不過，視訊迷你埠驅動程序必須先呼叫 AgpCommitPhysical ，才能認可此記憶體，才能進行存取，才能定義存取的結果。

迷你埠驅動程式可以呼叫 AgpReservePhysical 數次，以保留許多較小的位址範圍，而不是一個大型範圍。

迷你埠驅動程序應該呼叫 AgpReleasePhysical ，以在不再需要實體位址範圍時釋放實體地址範圍。

規格需求

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

另請參閱

AgpCommitPhysical

AgpReleasePhysical

AgpReserveVirtual