AgpFreePhysical routine

The AgpFreePhysical function frees system memory that was committed by a previous call to AgpCommitPhysical.

Syntax


PAGP_FREE_PHYSICAL AgpFreePhysical;

VOID APIENTRY AgpFreePhysical(
  _In_ PVOID HwDeviceExtension,
  _In_ PVOID PhysicalReserveContext,
  _In_ ULONG Pages,
  _In_ ULONG Offset
)
{ ... }

Parameters

HwDeviceExtension [in]

Pointer to the device extension of the miniport driver.

PhysicalReserveContext [in]

Identifies a reserved physical address range. This context handle was obtained from AgpReservePhysical.

Pages [in]

Specifies the number of pages of system memory that the video port driver should unmap.

Offset [in]

Specifies the page offset into the reserved physical address range identified by PhysicalReserveContext that indicates the actual base address at which to unmap system memory.

Return value

None

Remarks

When a miniport driver calls AgpFreePhysical, Pages pages of physical memory are unlocked and unmapped from the AGP-decodable physical address range. This range begins Offset pages into the range identified by PhysicalReserveContext. The miniport driver must specify that the exact offset and number of pages be freed as were committed in a prior call to AgpCommitPhysical.

Requirements

Target platform

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Videoagp.h (include Video.h)

IRQL

PASSIVE_LEVEL

See also

AgpCommitPhysical
AgpReleasePhysical

 

 

Send comments about this topic to Microsoft

Show: