PAGP_COMMIT_PHYSICAL funzione di callback (videoagp.h)
La funzione AgpCommitPhysical esegue il mapping della memoria di sistema (fisica) all'intervallo specificato di indirizzi fisici decodificabili 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 di cui eseguire 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 avuto esito positivo e FALSE in caso contrario.
Commenti
Un driver miniport video deve prima riservare indirizzi fisici chiamando AgpReservePhysical prima di chiamare questa funzione.
Non chiamare AgpCommitPhysical per eseguire il commit di indirizzi già sottoposti a commit. Se l'intervallo di pagine specificato da PhysicalReserveContext, Pages e 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 la cui dimensione è un multiplo di 64 kilobyte. La prenotazione o il commit di un intervallo fisico che non è un multiplo di 64 kilobyte può comportare la restituzione di un indirizzo virtuale non valido da AgpReserveVirtual o AgpCommitVirtual .
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 a pagine bloccate di memoria fisica. La parte mappata inizia le 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | videoagp.h (include Video.h) |
| IRQL | PASSIVE_LEVEL |