PAGP_COMMIT_PHYSICAL funzione di callback (videoagp.h)
Il AgpCommitPhysical funzione esegue il mapping della memoria di sistema (fisica) all'intervallo specificato di indirizzi fisici decodificabili da AGP.
Sintassi
PAGP_COMMIT_PHYSICAL PagpCommitPhysical;
BOOLEAN PagpCommitPhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN PVOID PhysicalReserveContext,
[in] IN ULONG Pages,
[in] IN ULONG Offset
)
{...}
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
[in] PhysicalReserveContext
Identifica un intervallo di indirizzi fisici riservati. L'handle di contesto viene ottenuto da AgpReservePhysical.
[in] Pages
Specifica il numero di pagine di memoria di sistema da eseguire per il commit.
[in] Offset
Specifica l'offset di pagina in corrispondenza del quale eseguire il commit delle pagine. L'offset viene applicato all'intervallo di indirizzi fisici riservati associato a PhysicalReserveContext.
Valore restituito
AgpCommitPhysical restituisce TRUE se il mapping ha esito positivo e false in caso contrario.
Osservazioni
Un driver miniport video deve prima prenotare gli indirizzi fisici chiamando AgpReservePhysical prima di chiamare questa funzione.
Non chiamare AgpCommitPhysical per eseguire il commit degli indirizzi già sottoposti a commit. Se l'intervallo di pagine specificato da PhysicalReserveContext, Pagese Offset include tutte le pagine di cui è stato eseguito il commit in precedenza, AgpCommitPhysical potrebbe non riuscire.
I driver miniport video eseguiti in Microsoft Windows 2000 devono sempre riservare ed eseguire il commit di un intervallo fisico le cui dimensioni sono multiple di 64 kilobyte. La prenotazione o il commit di un intervallo fisico che non è un multiplo di 64 kilobyte può comportare AgpReserveVirtual o AgpCommitVirtual restituendo un indirizzo virtuale non valido.
In Windows XP e versioni successive, AgpCommitPhysical espande automaticamente l'intervallo di commit in modo che sia un multiplo di 64 kilobyte.
Quando un driver miniport video chiama AgpCommitPhysical, viene eseguito il mapping di una parte dell'intervallo di indirizzi fisici identificato da PhysicalReserveContext alle pagine bloccate della memoria fisica. La parte mappata inizia pagine offset nell'intervallo identificato da PhysicalReserveContext. Il driver miniport video può accedere alla memoria fisica di cui è stato eseguito il commit come se fosse contiguo.
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 |