PAGP_FREE_PHYSICAL callback function (videoagp.h)

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

Syntax

PAGP_FREE_PHYSICAL PagpFreePhysical;

void PagpFreePhysical(
  [in] IN PVOID HwDeviceExtension,
  [in] IN PVOID PhysicalReserveContext,
  [in] IN ULONG Pages,
  [in] IN ULONG Offset
)
{...}

Parameters

[in] HwDeviceExtension

Pointer to the device extension of the miniport driver.

[in] PhysicalReserveContext

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

[in] Pages

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

[in] Offset

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

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

See also

AgpCommitPhysical

AgpReleasePhysical