PAGP_FREE_VIRTUAL Rückruffunktion (videoagp.h)
Die AgpFreeVirtual--Funktion gibt virtuellen Speicher frei, der durch einen vorherigen Aufruf von AgpCommitVirtualzugesichert wird.
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
Zeigen Sie auf die Geräteerweiterung des Miniporttreibers.
[in] VirtualReserveContext
Identifiziert einen reservierten virtuellen Adressbereich. Dieses Kontexthandle wurde von AgpReserveVirtualabgerufen.
[in] Pages
Gibt die Anzahl der Seiten des virtuellen Speichers an, die der Videoporttreiber aufheben soll.
[in] Offset
Gibt den Seitenoffset in den reservierten virtuellen Adressbereich an, der durch VirtualReserveContext identifiziert wird, der die tatsächliche Basisadresse angibt, an der die Zuordnung des virtuellen Speichers aufgehoben werden soll.
Rückgabewert
Nichts
Bemerkungen
Wenn ein Miniporttreiber AgpFreeVirtual-aufruft, werden Seiten Seiten virtueller Adressen nicht zugeordnet. Der nicht zugeordnete Bereich beginnt Offset- Seiten in den Bereich, der VirtualReserveContext-zugeordnet ist. Der Miniporttreiber muss angeben, dass der genaue Offset und die Anzahl der Seiten freigegeben werden, wie in einem vorherigen Aufruf von AgpCommitVirtual.
Ein Aufruf von AgpFreeVirtual- muss mit einem vorherigen Aufruf von AgpCommitVirtualgekoppelt sein, und diesem Aufruf an AgpCommitVirtual muss ein erfolgreicher Aufruf von AgpReserveVirtualvorausgehen. Wenn AgpReserveVirtual fehlschlägt (gibt NULL-zurück), dürfen Sie AgpCommitVirtual oder AgpFreeVirtualnicht aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 2000 und höheren Versionen von Windows-Betriebssystemen. |
| Zielplattform- | Desktop |
| Header- | videoagp.h (video.h einschließen) |
| IRQL- | PASSIVE_LEVEL |