Compartir a través de


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)

Consulte también

AVStrMiniRemoveEvent

KSAUTOMATION_TABLE

KSEVENTDATA

KSEVENT_ENTRY

KSEVENT_ITEM

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents