DXGKCB_AGP_ALLOCATE_POOL Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

Die DXGKCB_AGP_ALLOCATE_POOL Rückruffunktion reserviert, commits und ordnet den AGP-Speicher (Accelerated Graphics Port) zu.

Syntax

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
)
{...}

Parameter

[in] Context

Ein Handle zu einem Kontextblock, der einer AGP-Schnittstelle zugeordnet ist. Der Display-Miniporttreiber hat dieses Handle zuvor im Context Member der DXGK_AGP_INTERFACE Struktur erhalten, die von DxgkCbQueryServicesausgefüllt wurde.

[in] AllocationSize

Die Größe des zuzuordnenden AGP-Speichers in Bytes.

[in] CacheType

Eine Konstante aus der MEMORY_CACHING_TYPE-Aufzählung, die angibt, ob die CPU Zwischenspeicherung oder Schreibvorgänge verwenden kann, wenn sie auf den zugeordneten AGP-Speicher zugreift.

[out] PhysicalAddress

Ein Zeiger auf eine PHYSICAL_ADDRESS-Struktur, die die physische Basisadresse der AGP-Zuordnung empfängt. Dies ist die Basis des physischen Adressbereichs, den die GPU für den Zugriff auf den AGP-Speicher verwendet.

[out] VirtualAddress

Ein Zeiger auf eine Variable, die die virtuelle Basisadresse im Systembereich der AGP-Zuordnung empfängt. Dies ist die Basis des virtuellen Adressbereichs, den die CPU für den Zugriff auf den AGP-Speicher verwendet.

Rückgabewert

AgpAllocatePool gibt STATUS_SUCCESS zurück, wenn dies erfolgreich ist. Andernfalls wird eine der fehlercodes zurückgegeben, die in ntstatus.hdefiniert sind.

Bemerkungen

Rufen Sie AgpAllocatePool- in der DxgkDdiStartDevice-Funktion des Anzeigeminiporttreibers auf. Es ist wahrscheinlich, dass AgpAllocatePool- fehlschlägt, wenn Sie ihn aufrufen, nachdem DxgkDdiStartDevice ausgeführt wurde.