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
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | ks.h (inclure Ks.h) |