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 vers un bloc de contexte associé à une interface AGP. Le pilote miniport d’affichage a reçu précédemment ce handle dans le de contexte membre de la structure DXGK_AGP_INTERFACE qui a été renseignée 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 l’UC peut utiliser la mise en cache ou la combinaison d’écriture lorsqu’elle 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 physique 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 virtuelle que l’UC utilisera pour accéder à la mémoire AGP.
Valeur de retour
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 DxgkDdiStartDevicedu pilote miniport d’affichage. Il est probable que AgpAllocatePool échoue si vous l’appelez après DxgkDdiStartDevice a été exécuté.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista |
| plateforme cible | Bureau |
| d’en-tête | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |