PAGP_FREE_VIRTUAL funzione di callback (videoagp.h)

Articolo
02/26/2024

La funzione AgpFreeVirtual libera la memoria virtuale eseguita 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 annullare il mapping.

[in] Offset

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

Valore restituito

nessuno

Osservazioni

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

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

Requisiti

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

Vedi anche

AgpCommitVirtual

Condividi tramite