DXGKCB_AGP_ALLOCATE_POOL funzione di callback (dispmprt.h)

Articolo
02/06/2025

La funzione di callback DXGKCB_AGP_ALLOCATE_POOL riserva, esegue il commit e esegue il mapping della memoria AGP (Accelerated Graphics Port).

Sintassi

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

Parametri

[in] Context

Handle per un blocco di contesto associato a un'interfaccia AGP. Il driver di miniport di visualizzazione ha ricevuto in precedenza questo handle nel membro Context della struttura DXGK_AGP_INTERFACE compilata da DxgkCbQueryServices.

[in] AllocationSize

Dimensioni, in byte, della memoria AGP da allocare.

[in] CacheType

Costante dell'enumerazione MEMORY_CACHING_TYPE che specifica se la CPU può usare la memorizzazione nella cache o la combinazione di scrittura quando accede alla memoria AGP allocata.

[out] PhysicalAddress

Puntatore a una struttura PHYSICAL_ADDRESS che riceve l'indirizzo fisico di base dell'allocazione AGP. Questa è la base dell'intervallo di indirizzi fisici che la GPU userà per accedere alla memoria AGP.

[out] VirtualAddress

Puntatore a una variabile che riceve l'indirizzo virtuale di base, nello spazio di sistema, dell'allocazione AGP. Si tratta della base dell'intervallo di indirizzi virtuali che la CPU userà per accedere alla memoria AGP.

Valore restituito

AgpAllocatePool restituisce STATUS_SUCCESS se ha esito positivo. In caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.

Osservazioni

Chiamare AgpAllocatePool nella funzione DxgkDdiStartDevice del driver miniport. È probabile che AgpAllocatePool avrà esito negativo se viene chiamato dopo l'esecuzione di DxgkDdiStartDevice.