PAGP_FREE_VIRTUAL Rückruffunktion (videoagp.h)

Die AgpFreeVirtual-Funktion gibt virtuellen Arbeitsspeicher frei, der durch einen vorherigen Aufruf von AgpCommitVirtual committet wurde.

Syntax

PAGP_FREE_VIRTUAL PagpFreeVirtual;

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

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] VirtualReserveContext

Identifiziert einen reservierten virtuellen Adressbereich. Dieses Kontexthandle wurde von AgpReserveVirtual abgerufen.

[in] Pages

Gibt die Anzahl der Seiten des virtuellen Arbeitsspeichers an, die der Videoporttreiber aufheben soll.

[in] Offset

Gibt den Seitenoffset in den reservierten virtuellen Adressbereich an, der von VirtualReserveContext identifiziert wird und die tatsächliche Basisadresse angibt, an der die Zuordnung des virtuellen Arbeitsspeichers aufgehoben werden soll.

Rückgabewert

Keine

Bemerkungen

Wenn ein Miniporttreiber AgpFreeVirtual aufruft, werden Seiten mit virtuellen Adressen nicht zugeordnet. Der nicht zugeordnete Bereich beginnt Offsetseiten in den Bereich, der VirtualReserveContext zugeordnet ist. Der Miniporttreiber muss angeben, dass der genaue Offset und die Anzahl der Seiten wie in einem vorherigen Aufruf von AgpCommitVirtual freigegeben werden.

Ein Aufruf von AgpFreeVirtual muss mit einem vorherigen Aufruf von AgpCommitVirtual gekoppelt werden, und diesem Aufruf von AgpCommitVirtual muss ein erfolgreicher Aufruf von AgpReserveVirtual vorangestellt sein. Wenn AgpReserveVirtual fehlschlägt ( NULL zurückgibt), dürfen Sie AgpCommitVirtual oder AgpFreeVirtual nicht aufrufen.

Anforderungen

Weitere Informationen

AgpCommitVirtual