Función KsGenerateEvents (ks.h)

La función KsGenerateEvents genera eventos de un tipo indicado presente en Objetola lista de eventos.

void KsGenerateEvents(
  [in]           PVOID                      Object,
  [in, optional] const GUID                 *EventSet,
  [in]           ULONG                      EventId,
  [in]           ULONG                      DataSize,
  [in, optional] PVOID                      Data,
  [in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
  [in, optional] PVOID                      CallBackContext
);

[in] Object

Objeto en el que se van a generar eventos. Puede ser un objeto pin o filtro AVStream.

[in, optional] EventSet

Guid del conjunto de eventos que debe coincidir para determinar qué eventos se van a generar. Si este parámetro es NULL, no se tiene en cuenta el GUID establecido para determinar los eventos coincidentes.

[in] EventId

Identificador de evento que debe coincidir para determinar qué eventos se van a generar.

[in] DataSize

Tamaño en bytes de los datos con los que se va a generar el evento de datos.

[in, optional] Data

Puntero a un búfer de datos que se va a incluir en la notificación de eventos. Si el controlador no necesita transmitir información adicional a través de la notificación, establezca este parámetro opcional en NULL.

[in, optional] CallBack

Puntero a una función especificada por el llamador que se llama para determinar si se debe generar un evento determinado. Si se NULL, no se realiza ninguna comprobación de devolución de llamada para determinar si se debe generar un evento (solo se usan *EventSet *y EventId).

[in, optional] CallBackContext

Puntero a un contexto especificado por el llamador que se pasa a la función de devolución de llamada CallBack.

Ninguno

Al llamar a esta función, un minidriver debe colocar Data y callBackContext en un segmento de datos bloqueado y no paginable. Además, tenga en cuenta que el de devolución de llamada se realiza en DISPATCH_LEVEL. La función de devolución de llamada debe estar en un segmento bloqueado y debe estar preparada para ejecutarse en IRQL = DISPATCH_LEVEL. Tenga en cuenta que hay un problema adicional en DX8 solo: EventSet debe estar en un segmento de datos bloqueado.

Normalmente, los minidrivers no llaman a esta función directamente y, en su lugar, usan una de las versiones que realizan la conversión adecuada: KsFilterGenerateEvents o KsPinGenerateEvents.

Se genera un evento si está presente en la lista de eventos *Object y *EventId *coincide con el identificador del evento, EventSet coincide con el GUID establecido del evento o NULLy *CallBack *es NULL o autoriza la coincidencia.

callBack es una devolución de llamada especificada por el autor de llamada que se usa para determinar coincidencias adicionales. Se crea un prototipo de la siguiente manera:

BOOLEAN CallBack (IN PVOID Context, IN PKSEVENT_ENTRY EventEntry);

AVStream pasa el contenido del KsGenerateEvents parámetro de la rutina callBackContext en el parámetro Context de esta devolución de llamada. eventEntry es un puntero a una estructura KSEVENT_ENTRY que especifica el evento que se generaría. La función de devolución de llamada debe devolver TRUE si se debe generar este evento.

Para obtener más información, vea control de eventos en avStream y eventos KS.

KSEVENT_ENTRY

KsAddEvent

KsFilterGenerateEvents

KsPinGenerateEvents