DXGKCB_AGP_ALLOCATE_POOL funzione di callback (dispmprt.h)

La funzione di callback DXGKCB_AGP_ALLOCATE_POOL riserva, 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 a un blocco di contesto associato a un'interfaccia AGP. Il driver miniport visualizzato in precedenza ha ricevuto questo handle nel membro Contesto 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. Si tratta della base dell'intervallo di indirizzi fisici usato dalla GPU 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 usato dalla CPU 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.

Commenti

Chiamare AgpAllocatePool nella funzione DxgkDdiStartDevice del driver di visualizzazione. È probabile che AgpAllocatePool avrà esito negativo se lo chiami dopo l'esecuzione di DxgkDdiStartDevice .

Requisiti

Vedi anche

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices