DXGKCB_AGP_ALLOCATE_POOL función de devolución de llamada (dispmprt.h)

Artículo
08/07/2023

La función de devolución de llamada DXGKCB_AGP_ALLOCATE_POOL reserva, confirma y asigna memoria de puerto gráfico acelerado (AGP).

Sintaxis

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

Parámetros

[in] Context

Identificador de un bloque de contexto asociado a una interfaz AGP. El controlador de minipuerto de pantalla recibió previamente este identificador en el miembro Context de la estructura DXGK_AGP_INTERFACE rellenada por DxgkCbQueryServices.

[in] AllocationSize

Tamaño, en bytes, de la memoria AGP que se va a asignar.

[in] CacheType

Constante de la enumeración MEMORY_CACHING_TYPE que especifica si la CPU puede usar el almacenamiento en caché o la combinación de escritura cuando accede a la memoria AGP asignada.

[out] PhysicalAddress

Puntero a una estructura de PHYSICAL_ADDRESS que recibe la dirección física base de la asignación de AGP. Esta es la base del intervalo de direcciones físicos que usará la GPU para acceder a la memoria AGP.

[out] VirtualAddress

Puntero a una variable que recibe la dirección virtual base, en el espacio del sistema, de la asignación de AGP. Esta es la base del intervalo de direcciones virtuales que usará la CPU para acceder a la memoria de AGP.

Valor devuelto

AgpAllocatePool devuelve STATUS_SUCCESS si se realiza correctamente. De lo contrario, devuelve uno de los códigos de error definidos en Ntstatus.h.

Comentarios

Llame a AgpAllocatePool en la función DxgkDdiStartDevice del controlador de miniporte para mostrar. Es probable que se produzca un error en AgpAllocatePool si se llama después de que DxgkDdiStartDevice se haya ejecutado.