PAGP_SET_RATE fonction de rappel (videoagp.h)

La fonction AgpSetRate reprogramme le taux de transfert de données du chipset AGP.

Syntaxe

PAGP_SET_RATE PagpSetRate;

BOOLEAN PagpSetRate(
  [in] IN PVOID HwDeviceExtension,
  [in] IN ULONG AgpRate
)
{...}

Paramètres

[in] HwDeviceExtension

Pointeur vers l’extension de périphérique du pilote miniport.

[in] AgpRate

Spécifie le taux de transfert à définir. Cette valeur peut être l'une des suivantes :

Valeur	Signification
VIDEO_AGP_RATE_1X	Vitesse unique (66 Mhz)
VIDEO_AGP_RATE_2X	Vitesse deux fois unique
VIDEO_AGP_RATE_4X	Quatre fois la vitesse unique
VIDEO_AGP_RATE_8X	Huit fois la vitesse unique

Valeur retournée

AgpSetRate retourne TRUE s’il a réussi à modifier le taux de transfert ; sinon, il retourne FALSE.

Remarques

Cette fonction est disponible dans Microsoft Windows XP et versions ultérieures.

Le taux de transfert défini par la fonction AgpSetRate est persistant entre les changements d’état d’alimentation. Le pilote miniport vidéo n’a pas besoin de réinitialiser le taux de transfert AGP lorsqu’il passe d’un état d’alimentation faible à un état d’alimentation totale. Pour plus d’informations sur le changement d’état d’alimentation, consultez HwVidSetPowerState.

La fonction AgpSetRate peut être utilisée pour modifier le taux de transfert de données d’un chipset AGP en l’un des taux indiqués dans le tableau précédent, tant que ce taux de transfert n’a pas été explicitement éliminé dans le fichier INF qui a chargé le pilote d’affichage. Pour plus d’informations, consultez Afficher les sections de fichier INF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	videoagp.h (inclure Video.h)
IRQL	PASSIVE_LEVEL

Voir aussi

VIDEO_PORT_AGP_INTERFACE_2