PAGP_RESERVE_PHYSICAL funzione di callback (videoagp.h)

Articolo
11/01/2024

La funzione AgpReservePhysical riserva un intervallo di indirizzi fisici sul bus di sistema a 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

Enumerazione VIDEO_PORT_CACHE_TYPE che specifica il tipo di memorizzazione nella cache che deve essere utilizzata dal sistema.

[out] PhysicalReserveContext

Specifica il percorso 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 in caso di esito positivo; in caso contrario, restituisce NULL.

Osservazioni

I driver miniport video eseguiti in Windows 2000 devono sempre riservare un intervallo le cui dimensioni sono multiple di 64 kilobyte. La prenotazione di un intervallo che non è un multiplo di 64 kilobyte può comportare AgpReserveVirtual o AgpCommitVirtual restituendo un indirizzo virtuale non valido.

In Windows XP e versioni successive, AgpReservePhysical espande automaticamente l'intervallo richiesto a un multiplo 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 fare in modo che questa memoria venga sottoposta a commit prima di accedervi affinché i risultati accessibili vengano definiti.

Il driver miniport può chiamare AgpReservePhysical più volte per riservare molti intervalli di indirizzi più piccoli anziché un intervallo grande.

Il driver miniport deve chiamare AgpReleasePhysical per rilasciare l'intervallo di indirizzi fisici quando non è più necessario.