Función de devolución de llamada PFNKSADDEVENT (ks.h)

2025-02-07

Se llama a una rutina de AVStrMiniAdd Event de un minidriver de AVStream cuando se registra un cliente 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 de 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.

Observaciones

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. 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 el 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	Valor
cliente mínimo admitido	Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX.
de la plataforma de destino de	Escritorio
encabezado de	ks.h (incluya Ks.h)