Partager via

StreamClassCallAtNewPriority, fonction (strmini.h)

  • Article

La routine StreamClassCallAtNewPriority planifie l’appel d’une routine à une priorité différente.

Syntaxe

VOID STREAMAPI StreamClassCallAtNewPriority(
  [in, optional] PHW_STREAM_OBJECT    StreamObject,
  [in]           PVOID                HwDeviceExtension,
  [in]           STREAM_PRIORITY      Priority,
  [in]           PHW_PRIORITY_ROUTINE PriorityRoutine,
  [in]           PVOID                Context
);

Paramètres

[in, optional] StreamObject

Pointeur vers une structure HW_STREAM_OBJECT spécifiant le flux est associé à la routine, ou NULL si la routine est associée à l’appareil dans son ensemble. Il ne peut y avoir qu’une seule routine par flux et une seule routine pour l’appareil. Ce paramètre est facultatif.

[in] HwDeviceExtension

Pointeur vers l’extension d’appareil du minidriver. Le minidriver spécifie la taille de cette mémoire tampon dans la structure HW_INITIALIZATION_DATA qu’il transmet lorsqu’il s’inscrit via StreamClassRegisterMinidriver. Le pilote de classe passe ensuite des pointeurs vers la mémoire tampon dans le HwDeviceExtension membre du HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXTet PORT_CONFIGURATION_INFORMATION structures qu’il transmet au minidriver.

[in] Priority

Spécifie l’une des valeurs répertoriées dans le tableau suivant.

Priorité Usage
Haut Le pilote de classe de flux appelle la routine à la même priorité que les rappels de minidriver StrMiniXxx. N’utilisez pas ce paramètre, sauf si la routine doit être synchronisée avec la routine de service d’interruption du minidriver.
Dépêche Le pilote de classe de flux appelle la routine à DISPATCH_LEVEL. Utilisez cette priorité si la routine prend moins de 1 milliseconde.
Bas Le pilote de classe de flux appelle la routine à PASSIVE_LEVEL. Utilisez cette priorité si la routine prend moins de 1 milliseconde.
LowToHigh Permet à un thread appelé à priorité basse de revenir à une priorité élevée afin que d’autres services de pilotes de classe de flux puissent être appelés.

[in] PriorityRoutine

Pointeur vers un minidriver fourni StrMiniPriorityRoutine à appeler au niveau de priorité spécifié.

[in] Context

Spécifie le paramètre à passer à l'PriorityRoutine.

Valeur de retour

Aucun

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête strmini.h (include Strmini.h)
bibliothèque Stream.lib
IRQL (Voir la section Paramètres)