Función KsGenerateEvent (ks.h)
La función KsGenerateEvent genera una notificación de eventos estándar dada una estructura de entrada de evento.
Sintaxis
KSDDKAPI NTSTATUS KsGenerateEvent(
[in] PKSEVENT_ENTRY EventEntry
);
Parámetros
[in] EventEntry
Especifica la estructura de entrada de evento que hace referencia a los datos del evento. La información se usa para determinar qué tipo de notificación se va a realizar. Si el tipo de notificación no es uno de los estándares predefinidos, se devuelve un error. En el caso de un único evento no recurrente, esta entrada no será válida al devolver desde la función . Por lo tanto, cualquier código que enumere una lista de eventos debe preincrementarse para adquirir el siguiente evento en la lista antes de pasar este evento a la función .
Valor devuelto
La función KsGenerateEvent devuelve STATUS_SUCCESS si se ejecuta correctamente, o si no se ejecuta correctamente, devuelve una excepción o un error de memoria.
Comentarios
Un dispositivo determina cuándo se generan las notificaciones de eventos mediante la estructura KSEVENT_ENTRY y, a continuación, usa esta función para realizar la notificación real. Se puede llamar a KsGenerateEvent en cualquier IRQL. Si se llama anteriormente DISPATCH_LEVEL, la señalización del evento se realizará de forma asincrónica en un DPC.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluye Ks.h) |
| Library | Ks.lib |
| IRQL | Cualquier nivel (consulte la sección Comentarios) |