PAGP_RESERVE_PHYSICAL Rückruffunktion (videoagp.h)

  • Artikel

Die AgpReservePhysical-Funktion reserviert einen Bereich von physischen Adressen auf dem Systembus, auf den der AGP-Controller reagieren kann.

Syntax

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
)
{...}

Parameter

[in] HwDeviceExtension

Zeiger auf die Geräteerweiterung des Miniporttreibers.

[in] Pages

Gibt die Anzahl der Seiten an, die der Videoporttreiber reservieren soll.

[in] Caching

Gibt den Typ der Zwischenspeicherung an, die das System verwenden soll. Dieser Parameter kann auf einen der folgenden Werte festgelegt werden.

Wert Bedeutung
VpNonCached Das System sollte den Adressbereich nicht zwischenspeichern.
VpWriteCombined Das System sollte die kombinierte Schreib-Zwischenspeicherung (WC) verwenden. Informationen zum WC-Zwischenspeichern finden Sie im Websiteartikel Schreibkombinierender Arbeitsspeicher in Video-Miniporttreibern .
VpCached Das System sollte die normale Zwischenspeicherung verwenden.

[out] PhysicalReserveContext

Gibt den Speicherort an, an dem der Videoporttreiber ein Kontexthandle schreibt, das den reservierten physischen Adressraum identifiziert.

Rückgabewert

AgpReservePhysical gibt bei erfolgreicher Ausführung die Basisadresse des reservierten physischen Adressbereichs zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

Videominiporttreiber, die unter Microsoft Windows 2000 ausgeführt werden, sollten immer einen Bereich reservieren, dessen Größe ein Vielfaches von 64 KB beträgt. Das Reservieren eines Bereichs, der kein Vielfaches von 64 KB ist, kann dazu führen, dass AgpReserveVirtual oder AgpCommitVirtual eine ungültige virtuelle Adresse zurückgibt.

Unter Microsoft Windows XP und höher erweitert AgpReservePhysical den angeforderten Bereich automatisch auf ein Vielfaches von 64 KB.

Nach erfolgreicher Rückgabe kann der AGP-Controller auf den reservierten physischen Adressbereich auf dem Bus reagieren. Der Video-Miniporttreiber muss jedoch zuerst AgpCommitPhysical aufrufen, damit dieser Arbeitsspeicher vor dem Zugriff auf den Speicher committet wird, damit die Ergebnisse definiert werden, auf die zugegriffen wird.

Der Miniporttreiber kann AgpReservePhysical mehrmals aufrufen, um viele kleinere Adressbereiche anstelle eines großen Bereichs zu reservieren.

Der Miniporttreiber sollte AgpReleasePhysical aufrufen, um den physischen Adressbereich freizugeben, wenn er nicht mehr benötigt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile videoagp.h (einschließen von Video.h)
IRQL PASSIVE_LEVEL

Weitere Informationen

AgpCommitPhysical

AgpReleasePhysical

AgpReserveVirtual