Función KsGenerateDataEvent (ks.h)
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 |