PFND3DDDI_MAPGPUVIRTUALADDRESSCB回呼函式 （d3dumddi.h）
pfnMapGpuVirtualAddressCb 將 GPU 虛擬位址 （VA） 範圍對應至特定配置範圍，或將它放到 無效 或 零 狀態。
語法
PFND3DDDI_MAPGPUVIRTUALADDRESSCB Pfnd3dddiMapgpuvirtualaddresscb;
HRESULT Pfnd3dddiMapgpuvirtualaddresscb(
HANDLE hDevice,
D3DDDI_MAPGPUVIRTUALADDRESS *unnamedParam2
)
{...}
參數
hDevice
顯示裝置的句柄。
unnamedParam2
[in/out] pDate 是描述所要執行作業之 D3DDDI_MAPGPUVIRTUALADDRESS 結構的指標。
傳回值
pfnMapGpuVirtualAddressCb 會傳回下列其中一個值：
| 傳回碼 | 描述 |
|---|---|
| S_OK | 作業已順利完成。 |
| E_PENDING | 呼叫成功，但作業未完成。 呼叫端必須先等候傳回的柵欄值，才能存取配置。 |
此函式也可能傳回其他值。
言論
使用者模式驅動程式可以指定基底 GPU 虛擬位址 （VA） 來對應或讓視訊記憶體管理員自動挑選一個。 指定非 NULL BaseAddress 值時， 從 BaseAddress 到 BaseAddress+size 的整個範圍都必須處於釋放狀態，或屬於 透過呼叫 pfnMapGpuVirtualAddressCb 或 pfnReserveGpuVirtualAddressCb取得的 VA 範圍。 指定 Protection.Zero 或 Protection.NoAccess 時，VA 範圍不能屬於 呼叫 pfnMapGpuVirtualAddressCb取得的範圍。
使用者模式驅動程式除了預設一律存在讀取許可權之外，還可以指定對應是否應該允許寫入和執行許可權。
在鏈接的顯示配接器 （LDA） 組態中，分頁佇列會定義修改頁面數據表的實體 GPU，而配置句柄（如果不是 NULL）會定義頁面數據表專案指向的位置。 配置可以位於任何實體 GPU 記憶體區段中。
當配置（GPU VA 對應至）終結時，會釋出 API 所配置的 GPU VA 範圍。 VA 範圍也可以藉由呼叫 PFND3DDDI_FREEGPUVIRTUALADDRESSCB釋放，但如有必要，這必須與配置解構同步處理。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 10 |
| 支援的最低伺服器 | Windows Server 2016 |
| 目標平臺 | 桌面 |
| 標頭 | d3dumddi.h （包括 D3dumddi.h） |