Función KsFreeEventList (ks.h)
La función KsFreeEventList controla la liberación de todos los eventos de una lista especificada, con la suposición de que estos eventos se componen de estructuras de KSEVENT_ENTRY . Solo se puede llamar a esta función en PASSIVE_LEVEL.
Sintaxis
KSDDKAPI VOID KsFreeEventList(
[in] PFILE_OBJECT FileObject,
[in, out] PLIST_ENTRY EventsList,
[in] KSEVENTS_LOCKTYPE EventsFlags,
[in] PVOID EventsLock
);
Parámetros
[in] FileObject
Especifica el objeto de archivo pasado a la función de eliminación para obtener información de contexto. El objeto de archivo asociado se usa para comparar con el objeto de archivo especificado originalmente al habilitar el evento. Esto permite usar una sola lista de eventos para varios clientes diferenciados por objetos de archivo.
[in, out] EventsList
Apunta al encabezado de la lista de KSEVENT_ENTRY elementos que se van a liberar. Si los eventos de la lista se deshabilitan actualmente, se pasan. Si se agregan elementos nuevos a la lista mientras se está procesando, es posible que no se liberen.
[in] EventsFlags
Especifica una marca de KSEVENTS_LOCKTYPE que especifica el tipo de bloqueo de exclusión que se va a usar para acceder a la lista de eventos. Si no se establece ninguna marca, no se toma ningún bloqueo.
[in] EventsLock
Se usa para sincronizar el acceso a un elemento de la lista. Una vez al elemento al que se ha accedido, se marca como eliminado para que se produzca un error en las solicitudes de eliminación posteriores. A continuación, el bloqueo se libera después de llamar a la función de eliminación, si existe. La función de eliminación debe sincronizarse con la generación de eventos antes de quitar realmente el elemento de la lista.
Valor devuelto
None
Observaciones
La función KsFreeEventList llama al controlador remove y, a continuación, llama a KsDiscardEvent para cada evento. No supone que el autor de la llamada es el propietario del evento.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |