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

另請參閱

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices