Fonction de rappel PFNKSADDEVENT (ks.h)
Une routine de minidriver AVStream AVStrMiniAddEvent 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 de retour
AVStrMiniAddEvent doit retourner STATUS_SUCCESS ou une erreur spécifique à l’événement en cours d’activation.
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.
Ce rappel implémente fréquemment un comportement spécifique au fournisseur, puis appelle KsFilterAddEvent ou KsPinAddEvent. Le minidriver passe 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 des événements de l’objet. Si le 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Bureau |
| d’en-tête | ks.h (include Ks.h) |