PAGP_RESERVE_VIRTUAL callback function (videoagp.h)
The AgpReserveVirtual function reserves a range of virtual addresses for AGP.
Syntax
PAGP_RESERVE_VIRTUAL PagpReserveVirtual;
PVOID PagpReserveVirtual(
[in] IN PVOID HwDeviceExtension,
[in] IN HANDLE ProcessHandle,
[in] IN PVOID PhysicalReserveContext,
[out] OUT PVOID *VirtualReserveContext
)
{...}
Parameters
[in] HwDeviceExtension
Pointer to the miniport driver's device extension.
[in] ProcessHandle
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.
[in] PhysicalReserveContext
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.
[out] VirtualReserveContext
Is the location in which the video port driver writes a context handle that identifies the reserved virtual memory.
Return value
AgpReserveVirtual returns the base address of the reserved virtual address range if successful; otherwise, returns NULL.
Remarks
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 2000 and later versions of the Windows operating systems. |
| Target Platform | Desktop |
| Header | videoagp.h (include Video.h) |
| IRQL | PASSIVE_LEVEL |