StreamClassGetNextEvent, fonction (strmini.h)

Article
03/01/2024

Les minidrivers peuvent utiliser la routine StreamClassGetNextEvent pour rechercher dans la file d’attente d’événements d’un appareil ou d’un flux particulier.

Syntaxe

PKSEVENT_ENTRY StreamClassGetNextEvent(
  [in, optional] PVOID             HwInstanceExtension_OR_HwDeviceExtension,
  [in, optional] PHW_STREAM_OBJECT HwStreamObject,
  [in, optional] GUID              *EventGuid,
  [in]           ULONG             EventItem,
  [in, optional] PKSEVENT_ENTRY    CurrentEvent
);

Paramètres

[in, optional] HwInstanceExtension_OR_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 lui-même via StreamClassRegisterMinidriver. Le pilote de classe passe ensuite des pointeurs vers la mémoire tampon dans le membre HwDeviceExtension des structures HW_STREAM_REQUEST_BLOCK, HW_STREAM_OBJECT , HW_TIME_CONTEXT et PORT_CONFIGURATION_INFORMATION qu’il transmet au minidriver.

Ce premier paramètre était PVOID HwDeviceExtension. Il DOIT s’agir de HwInstanceExtension pour les pilotes multi-instance et multifiltres (version 20). Les pilotes de instance uniques hérités peuvent continuer à spécifier HwDeviceExtension comme premier paramètre. Il peut également spécifier HwInstanceExtension.

[in, optional] HwStreamObject

Pointeur vers un HW_STREAM_OBJECT. Définissez sur NULL pour rechercher la file d’attente d’événements de l’appareil lui-même. Pour rechercher dans la file d’attente d’événements d’un flux particulier, définissez sur l’objet de flux du flux.

[in, optional] EventGuid

Spécifie le jeu d’événements à mettre en correspondance lors de la marche à pied de la file d’attente, ou NULL pour correspondre à n’importe quel jeu d’événements.

[in] EventItem

Spécifie l’ID d’événement à mettre en correspondance lors de la marche à pied de la file d’attente, ou -1 pour correspondre à n’importe quel événement.

[in, optional] CurrentEvent

Pointeur vers un événement dans la file d’attente d’événements, ou NULL.

Valeur retournée

Si CurrentEvent n’a pas la valeur NULL, StreamClassGetNextEvent retourne l’événement correspondant suivant après CurrentEvent dans la file d’attente (ou NULL s’il n’existe aucun événement suivant). Si CurrentEvent a la valeur NULL, StreamClassGetNextEvent retourne le premier événement correspondant dans la file d’attente.

Remarques

Le minidriver peut appeler Successivement StreamClassGetNextEvent pour parcourir la file d’attente d’événements, en examinant un événement à la fois.

L’appelant peut spécifier des critères de recherche supplémentaires pour faire correspondre les événements dans la file d’attente d’événements.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	strmini.h (include Strmini.h)
Bibliothèque	Stream.lib

Partager via