Función KsGenerateDataEvent (ks.h)

  • Artículo

La función KsGenerateDataEvent genera una de las notificaciones de eventos estándar cuando se proporciona una estructura de entrada de evento y datos de devolución de llamada. Esto permite que un dispositivo determine cuándo se deben generar las notificaciones de eventos, pero sigue usando esta función auxiliar para realizar la notificación real.

Sintaxis

KSDDKAPI NTSTATUS KsGenerateDataEvent(
  [in] PKSEVENT_ENTRY EventEntry,
  [in] ULONG          DataSize,
  [in] PVOID          Data
);

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 cuando se devuelva de la función. Por lo tanto, cualquier código que enumera una lista de eventos debe preincrementar para adquirir el siguiente evento en la lista antes de pasar este evento a la función.

[in] DataSize

Especifica el tamaño en bytes del parámetro Data pasado.

[in] Data

Apunta a los datos que se van a pasar a la devolución de llamada del cliente. Estos datos se copian en una de las ranuras de búfer preasignadas configuradas cuando se habilitó el evento. El tamaño de los datos debe ser menor que lo que se haya asignado originalmente o se producirá un error en el evento.

Valor devuelto

La función KsGenerateDataEvent devuelve STATUS_SUCCESS si se ejecuta correctamente, o si no se realiza correctamente, devuelve una excepción o un error de memoria.

Comentarios

Se supone que se ha adquirido el bloqueo de lista de eventos antes de llamar a esta función. Esta función puede dar lugar a una llamada a RemoveHandler para la entrada del evento. Por lo tanto, no se debe llamar a la función en un nivel superior al nivel IRQ del bloqueo, o bien la función Remove debe ser capaz de controlar la llamada en este nivel de IRQ.

Esta función es específica para eventos que devuelven datos a través de una devolución de llamada a un cliente.

Requisitos

Requisito Value
Plataforma de destino Universal
Encabezado ks.h (incluya Ks.h)
Library Ks.lib

Consulte también

KSBUFFER_ITEM