DXGKCB_AGP_ALLOCATE_POOL回呼函式 (dispmprt.h)
DXGKCB_AGP_ALLOCATE_POOL回呼函式會保留、認可和對應加速圖形埠 (AGP) 記憶體。
語法
DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;
NTSTATUS DxgkcbAgpAllocatePool(
[in] IN HANDLE Context,
[in] IN ULONG AllocationSize,
[in] IN MEMORY_CACHING_TYPE CacheType,
[out] OUT PPHYSICAL_ADDRESS PhysicalAddress,
[out] OUT PVOID *VirtualAddress
)
{...}
參數
[in] Context
與 AGP 介面相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前在 DxgkCbQueryServices 填入之DXGK_AGP_INTERFACE結構的內容成員中收到此句柄。
[in] AllocationSize
要配置的 AGP 記憶體大小，以位元組為單位。
[in] CacheType
來自 MEMORY_CACHING_TYPE列舉的 常數，指定當 CPU 存取配置的 AGP 記憶體時，是否可以使用快取或寫入結合。
[out] PhysicalAddress
接收 AGP 配置基底實體位址之PHYSICAL_ADDRESS結構的指標。 這是 GPU 將用來存取 AGP 記憶體的實體位址範圍基底。
[out] VirtualAddress
在 AGP 配置的系統空間中接收基底虛擬位址的變數指標。 這是 CPU 將用來存取 AGP 記憶體的虛擬位址範圍基底。
傳回值
AgpAllocatePool 會在成功時傳回STATUS_SUCCESS。 否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
在顯示迷你埠驅動程式的 DxgkDdiStartDevice 函式中呼叫 AgpAllocatePool。 如果您在 DxgkDdiStartDevice 執行之後呼叫，AgpAllocatePool 可能會失敗。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 目標平台 | 桌面 |
| 標頭 | dispmprt.h (包括 Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |