Función KsGenerateEvent (ks.h)

Artículo
02/29/2024

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.