Función KsFilterGenerateEvents (ks.h)
La función KsFilterGenerateEvents genera eventos de un tipo indicado que está presente en la lista de eventos de Filter.
Sintaxis
void KsFilterGenerateEvents(
[in] PKSFILTER Filter,
[in, optional] const GUID *EventSet,
[in] ULONG EventId,
[in] ULONG DataSize,
[in] PVOID Data,
[in, optional] PFNKSGENERATEEVENTCALLBACK CallBack,
[in, optional] PVOID CallBackContext
);
Parámetros
[in] Filter
Puntero a una estructura KSFILTER en la que se van a generar eventos.
[in, optional] EventSet
Puntero al GUID del conjunto de eventos para que coincida con la determinación de los eventos que se van a generar. Si este parámetro es NULL, no se tiene en cuenta el GUID del conjunto de eventos para determinar los eventos coincidentes.
[in] EventId
Identificador de evento que se va a buscar para determinar qué eventos se van a generar.
[in] DataSize
Tamaño de datos en bytes.
[in] Data
Puntero a un búfer de datos. Especifique si genera un evento de datos.
[in, optional] CallBack
Puntero a una función especificada por el autor de la llamada que se llama para determinar si se debe generar un evento determinado. Si es 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 ). Para obtener más información, vea la sección Comentarios a continuación.
[in, optional] CallBackContext
Puntero opcional a un contexto especificado por el autor de la llamada que se pasa a la función de devolución de llamada CallBack. Para obtener más información, vea la sección Comentarios a continuación.
Valor devuelto
None
Observaciones
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 la 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 solo en DX8: EventSet debe estar en un segmento de datos bloqueado.
Se trata de una llamada de función insertada a KsGenerateEvents que realiza la difusión de tipos necesaria. Los minidrivers normalmente deben llamar a esta versión en lugar de llamar directamente a KsGenerateEvents.
Se genera un evento si las condiciones siguientes contienen:
El evento está presente en la lista de eventos de Filter y EventId coincide con el identificador del evento.
EventSet coincide con el GUID establecido del evento o es NULL.
CallBack es NULL o autoriza la coincidencia.
CallBack es una devolución de llamada especificada por el autor de la llamada que se usa para la determinación de coincidencia adicional. Se crea un prototipo de la siguiente manera:
BOOLEAN CallBack (IN PVOID Context, IN PKSEVENT_ENTRY EventEntry);
AVStream pasa el contenido del parámetro CallBackContext de la rutina KsFilterGenerateEvents en el parámetro Context de esta devolución de llamada. EventEntry es un puntero a una estructura de 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, consulte Control de eventos en EVENTOS AVStream y KS.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows XP y sistemas operativos posteriores y DirectX 8.0 y versiones posteriores de DirectX. |
| Plataforma de destino | Escritorio |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |
| IRQL | <=DISPATCH_LEVEL (vea la sección Comentarios). |