IMiniportWaveCycliqueStream ::SetNotificationFreq, méthode (portcls.h)

Article
02/07/2025

La méthode SetNotificationFreq contrôle la fréquence à laquelle les interruptions de notification sont générées en définissant l’intervalle entre les interruptions successives.

Syntaxe

ULONG SetNotificationFreq(
  [in]  ULONG  Interval,
  [out] PULONG FrameSize
);

Paramètres

[in] Interval

Spécifie l’intervalle entre les interruptions de notification. Cette valeur de paramètre est exprimée en millisecondes.

[out] FrameSize

Pointeur de sortie pour la taille d’image. Ce paramètre pointe vers une variable allouée par l’appelant dans laquelle la méthode écrit le nombre maximal d’octets pouvant être transférés dans Interval millisecondes. Ce nombre d’octets détermine la taille de la mémoire tampon qui doit être allouée pour le flux d’entrée ou de sortie.

Valeur de retour

SetNotificationFreq retourne le nouvel intervalle de notification exprimé en millisecondes. Dans toutes les versions actuelles de Windows, le pilote de port ignore cette valeur.

Remarques

Pendant chaque interruption de notification, la routine de service d’interruption du pilote miniport appelle la méthode IPortWaveCyclique ::Notify avec l’objet IServiceGroup du flux comme paramètre d’appel. Il s’agit de l’objet IServiceGroup que le pilote miniport a précédemment généré vers le pilote de port pendant l’appel IMiniportWaveCyclique ::NewStream.

Dans toutes les versions actuelles de Windows, le pilote de port WaveCyclique spécifie une valeur de Interval de 10 millisecondes. Cette valeur peut changer dans les versions ultérieures.