AgpFreeVirtual routine

The AgpFreeVirtual function frees virtual memory committed by a previous call to AgpCommitVirtual.

Syntax


PAGP_FREE_VIRTUAL AgpFreeVirtual;

VOID APIENTRY AgpFreeVirtual(
  _In_  PVOID HwDeviceExtension,
  _In_  PVOID VirtualReserveContext,
  _In_  ULONG Pages,
  _In_  ULONG Offset
)
{ ... }

Parameters

HwDeviceExtension [in]

Pointer to the miniport driver's device extension.

VirtualReserveContext [in]

Identifies a reserved virtual address range. This context handle was obtained from AgpReserveVirtual.

Pages [in]

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

Offset [in]

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

Return value

None

Remarks

When a miniport driver calls AgpFreeVirtual, Pages pages of virtual addresses are unmapped. The unmapped range begins Offset pages into the range associated with VirtualReserveContext. The miniport driver must specify that the exact offset and number of pages be freed as were committed in a prior call to AgpCommitVirtual.

A call to AgpFreeVirtual must be paired with a previous call to AgpCommitVirtual, and that call to AgpCommitVirtual must be preceded by a successful call to AgpReserveVirtual. If AgpReserveVirtual fails (returns NULL), you must not call AgpCommitVirtual or AgpFreeVirtual.

Requirements

Version

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

Header

Videoagp.h (include Video.h)

IRQL

PASSIVE_LEVEL

See also

AgpCommitVirtual

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft