structure KSEVENT_ITEM (ks.h)
La structure KSEVENT_ITEM décrivent la prise en charge d’un minidriver pour un événement spécifique au sein d’un jeu d’événements.
Syntaxe
typedef struct {
ULONG EventId;
ULONG DataInput;
ULONG ExtraEntryData;
PFNKSADDEVENT AddHandler;
PFNKSREMOVEEVENT RemoveHandler;
PFNKSHANDLER SupportHandler;
} KSEVENT_ITEM, *PKSEVENT_ITEM;
Membres
EventId
Spécifie l’ID unique de l’événement dans le jeu d’événements.
DataInput
Spécifie la taille en octets des données d’événement. Les données d’événement commencent par une structure KSEVENTDATA qui décrit la façon dont le client doit être averti lorsque l’événement se produit, éventuellement suivi de tous les paramètres supplémentaires qui spécifient quand l’événement se produit. Doit être au moins taille de(KSEVENTDATA).
ExtraEntryData
Spécifie la taille en octets de toute mémoire supplémentaire que le système doit allouer pour chaque demande d’activation de cet événement. Le pilote utilise cette mémoire pour stocker les données dont il a besoin pour suivre la demande d’événement. La mémoire est allouée directement après l’activation de la structure KSEVENT_ENTRY de la requête.
AddHandler
Pointeur vers une routine de rappel fournie par minidriver AVStrMiniAddEvent. Non utilisé par le pilote de classe de flux. Pour les minidrivers AVStream uniquement.
RemoveHandler
Pointeur vers une routine de rappel fournie par minidriver AVStrMiniRemoveEvent. Non utilisé par le pilote de classe de flux. Pour les minidrivers AVStream uniquement.
SupportHandler
Non utilisé par le pilote de classe de flux.
Remarques
Minidriver qui spécifie les AddHandler et membres RemoveHandler et ne nettoie pas correctement les événements peut entraîner une fuite de ressources (mémoire/handle).
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ks.h (include Ks.h) |