DXGKCB_AGP_ALLOCATE_POOL Rückruffunktion (dispmprt.h)

Artikel
02/23/2024

Die DXGKCB_AGP_ALLOCATE_POOL Rückruffunktion reserviert, commits und ordnet AGP-Arbeitsspeicher (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 für einen Kontextblock, der einer AGP-Schnittstelle zugeordnet ist. Der Anzeige-Miniporttreiber hat dieses Handle zuvor im Kontextelement der DXGK_AGP_INTERFACE-Struktur empfangen, die von DxgkCbQueryServices ausgefüllt wurde.

[in] AllocationSize

Die Größe des zuzuweisenden AGP-Arbeitsspeichers in Bytes.

[in] CacheType

Eine Konstante aus der MEMORY_CACHING_TYPE-Enumeration , die angibt, ob die CPU beim Zugriff auf den zugeordneten AGP-Arbeitsspeicher zwischenspeichern oder schreiben kann.

[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-Arbeitsspeicher 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-Arbeitsspeicher verwendet.

Rückgabewert

AgpAllocatePool gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der in Ntstatus.h definierten Fehlercodes zurückgegeben.

Hinweise

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