Partager via

Fonction StreamClassCallAtNewPriority (strmini.h)

  • Article

La routine StreamClassCallAtNewPriority planifie une routine à appeler à une autre priorité.

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 de l’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 transmet ensuite des pointeurs vers la mémoire tampon dans le membre HwDeviceExtension du HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT, HW_TIME_CONTEXT et 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é Utilisation
Élevé Le pilote de classe de flux appelle la routine à la même priorité que les rappels StrMiniXxx du minidriver. N’utilisez pas ce paramètre, sauf si la routine doit être synchronisée avec la routine de service d’interruption du minidriver.
Dispatch Le pilote de classe de flux appelle la routine à DISPATCH_LEVEL. Utilisez cette priorité si la routine prend moins d’une milliseconde.
Faible Le pilote de classe de flux appelle la routine à PASSIVE_LEVEL. Utilisez cette priorité si la routine prend moins d’une milliseconde.
LowToHigh Utilisé pour permettre à un thread appelé à faible priorité 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 StrMiniPriorityRoutine fourni par minidriver à appeler au niveau de priorité spécifié.

[in] Context

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

Valeur de retour

None

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête strmini.h (inclure Strmini.h)
Bibliothèque Stream.lib
IRQL (Voir la section Paramètres)