Fonction de rappel PFNKSADDEVENT (ks.h)

La routine AVStrMiniAddEvent d’un minidriver AVStream est appelée lorsqu’un client s’inscrit pour être averti d’un événement. Cette routine est facultative.

Syntaxe

PFNKSADDEVENT Pfnksaddevent;

NTSTATUS Pfnksaddevent(
  [in] PIRP Irp,
  [in] PKSEVENTDATA EventData,
  [in] _KSEVENT_ENTRY *EventEntry
)
{...}

Paramètres

[in] Irp

Spécifie l’IRP décrivant la demande d’ajout d’événement.

[in] EventData

Pointeur vers une structure KSEVENTDATA décrivant la méthode de notification pour cet événement.

[in] EventEntry

Pointeur vers une structure de KSEVENT_ENTRY générée par AVStream décrivant la façon dont l’événement est déclenché.

Valeur retournée

AVStrMiniAddEvent doit retourner STATUS_SUCCESS ou une erreur spécifique à l’événement activé.

Remarques

Si vous ne fournissez pas de gestionnaire d’événements d’ajout, AVStream ajoute l’événement à la liste d’objets. Consultez Gestion des événements dans AVStream.

Souvent, ce rappel implémente un comportement propre au fournisseur, puis appelle KsFilterAddEvent ou KsPinAddEvent. Le minidriver transmet le pointeur EventEntry reçu ici dans les appels à KsFilterAddEvent ou KsPinAddEvent.

Le minidriver spécifie l’adresse de cette routine dans le membre AddHandler d’une structure KSEVENT_ITEM . Gestion des événements dans AVStream décrit comment le minidriver fournit cette structure au pilote de classe.

Si un minidriver AVStream spécifie AddHandler comme non NULL, AVStream n’ajoute pas l’élément à la liste d’événements de l’objet. Si minidriver spécifie un AddHandler et n’ajoute pas l’événement à la liste des événements de l’objet via KsDefaultAddEventHandler() ou un appel Ks*AddEvent , le minidriver est responsable du nettoyage de l’événement.

Configuration requise

Voir aussi

AVStrMiniRemoveEvent

KSAUTOMATION_TABLE

KSEVENTDATA

KSEVENT_ENTRY

KSEVENT_ITEM

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents