PAGP_RESERVE_PHYSICAL funzione di callback (videoagp.h)
La funzione AgpReservePhysical riserva un intervallo di indirizzi fisici nel bus di sistema in cui il controller AGP può rispondere.
Sintassi
PAGP_RESERVE_PHYSICAL PagpReservePhysical;
PHYSICAL_ADDRESS PagpReservePhysical(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG Pages,
[in] IN VIDEO_PORT_CACHE_TYPE Caching,
[out] OUT PVOID *PhysicalReserveContext
)
{...}
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo del driver miniport.
[in] Pages
Specifica il numero di pagine che il driver della porta video deve riservare.
[in] Caching
Specifica il tipo di memorizzazione nella cache che deve essere usato dal sistema. Questo parametro può essere impostato su uno dei valori seguenti.
Valore | Significato |
---|---|
VpNonCached | Il sistema non deve memorizzare nella cache l'intervallo di indirizzi. |
VpWriteCombined | Il sistema deve usare la memorizzazione nella cache combinata di scrittura (WC). Per informazioni sulla memorizzazione nella cache WC, vedere l'articolo Relativo alla combinazione di memoria in Video Miniport Driver . |
VpCached | Il sistema deve usare la memorizzazione nella cache normale. |
[out] PhysicalReserveContext
Specifica la posizione in cui il driver della porta video scrive un handle di contesto che identifica lo spazio indirizzi fisico riservato.
Valore restituito
AgpReservePhysical restituisce l'indirizzo di base dell'intervallo di indirizzi fisici riservati se riuscito; in caso contrario, restituisce NULL.
Commenti
I driver miniport video eseguiti in Microsoft Windows 2000 devono sempre riservare un intervallo le cui dimensioni sono più di 64 kilobyte. Riservare un intervallo che non è un multiplo di 64 kilobyte può causare a AgpReserveVirtual o AgpCommitVirtual che restituisce un indirizzo virtuale non valido.
In Microsoft Windows XP e versioni successive AgpReservePhysical espande automaticamente l'intervallo richiesto a più di 64 kilobyte.
Al termine della restituzione, il controller AGP può rispondere all'intervallo di indirizzi fisici riservati nel bus. Tuttavia, il driver miniport video deve prima chiamare AgpCommitPhysical per causare il commit di questa memoria prima di accedervi per poter definire i risultati accessibili.
Il driver miniport può chiamare AgpReservePhysical più volte per riservare molti intervalli di indirizzi più piccoli anziché un intervallo di grandi dimensioni.
Il driver miniport deve chiamare AgpReleasePhysical per rilasciare l'intervallo di indirizzi fisici quando non è più necessario.
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 |