PAGP_SET_RATE Rückruffunktion (videoagp.h)
Die AgpSetRate-Funktion programmiert die Datenübertragungsrate des AGP-Chipsatzes neu.
Syntax
PAGP_SET_RATE PagpSetRate;
BOOLEAN PagpSetRate(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG AgpRate
)
{...}
Parameter
[in] HwDeviceExtension
Zeiger auf die Geräteerweiterung des Miniporttreibers.
[in] AgpRate
Gibt die festzulegende Übertragungsrate an. Die folgenden Werte sind möglich:
| Wert | Bedeutung |
|---|---|
| VIDEO_AGP_RATE_1X | Einzelgeschwindigkeit (66 MHz) |
| VIDEO_AGP_RATE_2X | Zwei Mal single speed |
| VIDEO_AGP_RATE_4X | Viermal single speed |
| VIDEO_AGP_RATE_8X | Achtmal single speed |
Rückgabewert
AgpSetRate gibt TRUE zurück, wenn die Übertragungsrate erfolgreich geändert wurde. Andernfalls wird FALSE zurückgegeben.
Hinweise
Diese Funktion ist in Microsoft Windows XP und höher verfügbar.
Die von der AgpSetRate-Funktion festgelegte Übertragungsrate ist bei Änderungen im Energiezustand persistent. Der Video-Miniporttreiber muss die AGP-Übertragungsrate nicht zurücksetzen, wenn er von einem niedrigen Leistungszustand in einen vollständigen Leistungszustand wechselt. Informationen zum Ändern des Energiezustands finden Sie unter HwVidSetPowerState.
Die AgpSetRate-Funktion kann verwendet werden, um die Datenübertragungsrate eines AGP-Chipsatzes in eine der in der vorherigen Tabelle angegebenen Raten zu ändern, solange diese Übertragungsrate nicht explizit in der INF-Datei entfernt wurde, die den Anzeigetreiber geladen hat. Weitere Informationen finden Sie unter Anzeigen von INF-Dateiabschnitten.
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 |