PAGP_FREE_VIRTUAL funzione di callback (videoagp.h)

Articolo
02/07/2025

La funzione AgpFreeVirtual libera la memoria virtuale di cui è stato eseguito il commit da una chiamata precedente a AgpCommitVirtual.

Sintassi

PAGP_FREE_VIRTUAL PagpFreeVirtual;

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] VirtualReserveContext

Identifica un intervallo di indirizzi virtuali riservato. Questo handle di contesto è stato ottenuto da AgpReserveVirtual.

[in] Pages

Specifica il numero di pagine di memoria virtuale che il driver della porta video deve rimuovere dal mapping.

[in] Offset

Specifica l'offset di pagina nell'intervallo di indirizzi virtuali riservato identificato da VirtualReserveContext che indica l'indirizzo di base effettivo in corrispondenza del quale rimuovere il mapping della memoria virtuale.

Valore restituito

Nessuno

Osservazioni

Quando un driver miniport chiama AgpFreeVirtual, Pagine pagine di indirizzi virtuali non mappate. L'intervallo non mappato inizia pagine offset nell'intervallo associato a VirtualReserveContext. Il driver miniport deve specificare che l'offset esatto e il numero di pagine vengono liberati come eseguito in una chiamata precedente a AgpCommitVirtual.

Una chiamata a AgpFreeVirtual deve essere associata a una chiamata precedente a AgpCommitVirtuale tale chiamata a AgpCommitVirtual deve essere preceduta da una chiamata riuscita a AgpReserveVirtual. Se AgpReserveVirtual ha esito negativo (restituisce NULL), non è necessario chiamare AgpCommitVirtual o AgpFreeVirtual.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	videoagp.h (includere Video.h)
IRQL	PASSIVE_LEVEL

Vedere anche

AgpCommitVirtual

Condividi tramite