共用方式為


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 介面相關聯的內容區塊句柄。 顯示迷你埠驅動程式先前在 Context 成員中收到這個句柄,該DXGK_AGP_INTERFACE結構成員已由 dxgkCbQueryServices 填入。

[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