Función de devolución de llamada PFNKSADDEVENT (ks.h)
Se llama a la rutina AVStrMiniAddEvent de un minidriver avStream cuando un cliente se registra para recibir una notificación de un evento. Esta rutina es opcional.
Sintaxis
PFNKSADDEVENT Pfnksaddevent;
NTSTATUS Pfnksaddevent(
[in] PIRP Irp,
[in] PKSEVENTDATA EventData,
[in] _KSEVENT_ENTRY *EventEntry
)
{...}
Parámetros
[in] Irp
Especifica el IRP que describe la solicitud de adición de eventos.
[in] EventData
Puntero a una estructura KSEVENTDATA que describe el método de notificación para este evento.
[in] EventEntry
Puntero a una estructura de KSEVENT_ENTRY generada por AVStream que describe cómo se desencadena el evento.
Valor devuelto
AVStrMiniAddEvent debe devolver STATUS_SUCCESS o un error específico del evento que se está habilitando.
Comentarios
Si no proporciona un controlador de eventos add, AVStream agrega el evento a la lista de objetos. Consulte Control de eventos en AVStream.
Con frecuencia, esta devolución de llamada implementa un comportamiento específico del proveedor y, a continuación, llama a KsFilterAddEvent o KsPinAddEvent. El minidriver pasa el puntero EventEntry recibido aquí en llamadas a KsFilterAddEvent o KsPinAddEvent.
El minidriver especifica la dirección de esta rutina en el miembro AddHandler de una estructura de KSEVENT_ITEM . El control de eventos en AVStream describe cómo el minidriver proporciona esta estructura al controlador de clase.
Si un minidriver AVStream especifica AddHandler como no NULL, AVStream no agrega el elemento a la lista de eventos del objeto. Si minidriver especifica un AddHandler y no agrega el evento a la lista de eventos del objeto a través de KsDefaultAddEventHandler() o una llamada Ks*AddEvent , el minidriver es responsable de limpiar el evento.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y en sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Escritorio |
| Encabezado | ks.h (incluye Ks.h) |