PAGP_RESERVE_VIRTUAL - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// videoagp.h
PAGP_RESERVE_VIRTUAL PagpReserveVirtual;
PVOID PagpReserveVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN HANDLE ProcessHandle,
[in] IN PVOID PhysicalReserveContext,
[out] OUT PVOID *VirtualReserveContext
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
The AgpReserveVirtual function reserves a range of virtual addresses for AGP.
HwDeviceExtension [in]Pointer to the miniport driver's device extension.
ProcessHandle [in]Handle of the process in which to reserve the virtual address range. If ProcessHandle is 0, then the virtual address range is allocated in system space.
PhysicalReserveContext [in]Is the context handle that identifies the reserved physical address range with which to associate the virtual memory reservation. This context was obtained from AgpReservePhysical.
VirtualReserveContext [out]Is the location in which the video port driver writes a context handle that identifies the reserved virtual memory.
AgpReserveVirtual returns the base address of the reserved virtual address range if successful; otherwise, returns NULL.
If ProcessHandle is not 0, then AgpReserveVirtual reserves, but does not commit, a range of virtual addresses in the address space of a user-mode process. In that case, you must call AgpCommitVirtual to map the reserved (user-mode) virtual addresses to physical addresses.
If ProcessHandle is 0, then AgpReserveVirtual allocates a range of virtual addresses in system space and automatically maps (commits) the entire range of virtual addresses to physical addresses. Even though AgpReserveVirtual commits the entire virtual range, you still must call AgpCommitVirtual before any code accesses the virtual range.
When you call AgpReserveVirtual to allocate a range of virtual addresses in system space (that is, if you set ProcessHandle to 0), the entire range of physical addresses identified by PhysicalReserveContext must be committed to locked pages of physical memory by a previous call to AgpCommitPhysical.
The miniport driver can call AgpReleaseVirtual several times to reserve many smaller address ranges rather than one big range.
The miniport driver should call AgpReleaseVirtual to release the reserved virtual address range when it is no longer needed.