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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | videoagp.h (einschließen von Video.h) |
| IRQL | PASSIVE_LEVEL |