VideoPortMapBankedMemory 函式（video.h）

2025-02-07

VideoPortMapBankedMemory 函式 過時的，而且僅支援 Windows NT 4.0 和舊版驅動程式。 Windows 2000 和更新版本的驅動程式必須使用 VideoPortMapMemory。

VideoPortMapBankedMemory 會將總線相對實體的視訊記憶體範圍重新對應至對應的顯示驅動程式虛擬地址空間，以回應具有 IoControlCode 成員設定為 IOCTL_VIDEO_SHARE_VIDEO_MEMORY 或 IOCTL_VIDEO_MAP_VIDEO_MEMORY的 VRP。

語法

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortMapBankedMemory(
  PVOID                   HwDeviceExtension,
  PHYSICAL_ADDRESS        PhysicalAddress,
  PULONG                  Length,
  PULONG                  InIoSpace,
  PVOID                   *VirtualAddress,
  ULONG                   BankLength,
  UCHAR                   ReadWriteBank,
  PBANKED_SECTION_ROUTINE BankRoutine,
  PVOID                   Context
);

參數

HwDeviceExtension

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

PhysicalAddress

指定要對應之範圍的總線相對基位址。

Length

變數的指標，指定要對應的裝置記憶體位元組總數（不論銀行大小為何）。 VideoPortMapBankedMemory 會傳回對應記憶體的實際大小，其可在此參數中四捨五入為系統決定的對齊界限。不過，迷你埠和顯示驅動程式無法在 Length分隔的範圍之外存取記憶體。

InIoSpace

指出範圍的位置。此參數可以是下列其中一個值：

價值	意義
VIDEO_MEMORY_SPACE_DENSE	過時
VIDEO_MEMORY_SPACE_IO	此範圍位於系統 I/O 空間中，而不是記憶體空間中。
VIDEO_MEMORY_SPACE_MEMORY	此範圍位於記憶體空間中，而不是在系統 I/O 空間中。
VIDEO_MEMORY_SPACE_P6CACHE	處理器會匯總一連串的寫入作業，並將其傳送至指定的快取行。處理器接著會排清快取。只有在未設定VIDEO_MEMORY_SPACE_IO時，此旗標才有意義。
VIDEO_MEMORY_SPACE_USER_MODE	指出指定的位址範圍應該對應到使用者模式，而不是核心模式。只有在未設定VIDEO_MEMORY_SPACE_IO時，此旗標才有意義。

VirtualAddress

這是記憶體必須對應的進程句柄，或 NULL。 NULL 指定埠驅動程式應該對應目前進程位址空間中任何位置的邏輯記憶體範圍。否則，此句柄可以是由迷你埠驅動程式對應的顯示驅動程式傳入 VRP 的值。從成功呼叫傳回時，VideoPortMapBankedMemory 會將變數重設為已對應指定 PhysicalAddress的基底虛擬位址。

BankLength

指定銀行的大小，以位元組為單位。

ReadWriteBank

如果設定為 TRUE 銀行為 Read\Write;如果設定為 FALSE 有兩個獨立的讀取和寫入銀行。

BankRoutine

驅動程式提供的指標 HwVidBankedMemoryCallback 函式，當顯示驅動程式存取新的銀行時，記憶體管理員會呼叫此函式。

Context

當呼叫 BankRoutine 時，會傳回給驅動程式的迷你埠驅動程式提供內容指標。

傳回值

如果指定的邏輯範圍已成功對應至用戶空間虛擬範圍，VideoPortMapBankedMemory 會傳回NO_ERROR。否則，它可以傳回ERROR_INVALID_PARAMETER。

言論

VideoPortMapBankedMemory 在起始呼叫的使用者模式線程相同的內容中執行。

VideoPortMapBankedMemory 是由迷你埠驅動程式呼叫，以有效率地管理限制在銀行中對應框架緩衝區的 x86 類型裝置。當這個例程傳回呼叫端時，迷你埠驅動程式所管理的框架緩衝區會對應為線性框架緩衝區到要求進程的位址空間（請參閱 VirtualAddress 參數）。當存取該對應空間中的位址時，記憶體管理員會呼叫迷你埠驅動程式來更新銀行索引緩存器，以指向包含目前參考位址的新銀行。銀行指數快取器是由 BankRoutine中的迷你埠驅動程序維護的。正確的銀行索引是由記憶體管理員以透明方式計算給顯示驅動程式，並在回呼中傳遞至迷你埠驅動程式，以 BankRoutine。

要求

要求	價值
最低支援的用戶端	適用於 Windows 2000 和更新版本的 Windows作系統。
目標平臺	桌面
標頭	video.h （include Video.h）
連結庫	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL