Partager via


DXGKCB_AGP_ALLOCATE_POOL fonction de rappel (dispmprt.h)

La fonction de rappel DXGKCB_AGP_ALLOCATE_POOL réserve, valide et mappe la mémoire AGP (Accelerated Graphics Port).

Syntaxe

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

Paramètres

[in] Context

Handle pour un bloc de contexte associé à une interface AGP. Le pilote de miniport d’affichage a précédemment reçu ce handle dans le membre Context de la structure DXGK_AGP_INTERFACE qui a été remplie par DxgkCbQueryServices.

[in] AllocationSize

Taille, en octets, de la mémoire AGP à allouer.

[in] CacheType

Constante de l’énumération MEMORY_CACHING_TYPE qui spécifie si le processeur peut utiliser la mise en cache ou la combinaison d’écritures lorsqu’il accède à la mémoire AGP allouée.

[out] PhysicalAddress

Pointeur vers une structure PHYSICAL_ADDRESS qui reçoit l’adresse physique de base de l’allocation AGP. Il s’agit de la base de la plage d’adresses physiques que le GPU utilisera pour accéder à la mémoire AGP.

[out] VirtualAddress

Pointeur vers une variable qui reçoit l’adresse virtuelle de base, dans l’espace système, de l’allocation AGP. Il s’agit de la base de la plage d’adresses virtuelles que le processeur utilisera pour accéder à la mémoire AGP.

Valeur retournée

AgpAllocatePool retourne STATUS_SUCCESS si elle réussit. Sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Appelez AgpAllocatePool dans la fonction DxgkDdiStartDevice du pilote miniport d’affichage. Il est probable qu’AgpAllocatePool échoue si vous l’appelez après l’exécution de DxgkDdiStartDevice .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Plateforme cible Desktop (Expérience utilisateur)
En-tête dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

Voir aussi

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices