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 |