Méthode IMiniportWaveCyclicStream ::SetNotificationFreq (portcls.h)

Article
02/26/2024

La SetNotificationFreq méthode 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 de l’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 en millisecondes d’intervalle . 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 retournée

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 du service d’interruption du pilote miniport appelle la méthode IPortWaveCyclic ::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é sur le pilote de port lors de l’appel IMiniportWaveCyclic ::NewStream .

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