Compartir a través de


Función FsRtlNotifyFullChangeDirectory (ntifs.h)

El FsRtlNotifyFullChangeDirectory rutina crea una estructura de notificación para una solicitud de notificación y la agrega a la lista de notificaciones especificada.

Sintaxis

void FsRtlNotifyFullChangeDirectory(
  [in]           PNOTIFY_SYNC               NotifySync,
  [in]           PLIST_ENTRY                NotifyList,
  [in]           PVOID                      FsContext,
  [in]           PSTRING                    FullDirectoryName,
  [in]           BOOLEAN                    WatchTree,
  [in]           BOOLEAN                    IgnoreBuffer,
  [in]           ULONG                      CompletionFilter,
  [in, optional] PIRP                       NotifyIrp,
  [in, optional] PCHECK_FOR_TRAVERSE_ACCESS TraverseCallback,
  [in, optional] PSECURITY_SUBJECT_CONTEXT  SubjectContext
);

Parámetros

[in] NotifySync

Puntero a un objeto de sincronización opaco para la lista de notificaciones del volumen actual.

[in] NotifyList

Puntero al encabezado de una lista de notificaciones. Cada elemento de la lista es una estructura de notificación opaca.

[in] FsContext

Puntero a un valor único asignado por el sistema de archivos para identificar la estructura de notificación que se va a crear como perteneciente a un objeto de archivo determinado. Si se proporciona una rutina de TraverseCallback, se pasa FsContext como parámetro NotifyContext a esa rutina.

[in] FullDirectoryName

Puntero a una cadena ANSI o Unicode que contiene el nombre completo del directorio asociado a esta estructura de notificación. Se omite si NotifyIrp es NULL.

[in] WatchTree

Establézcalo en TRUE si también se deben observar todos los subdirectorios de este directorio. Establézcalo en FALSE si solo se va a ver el directorio. Se omite si NotifyIrp es NULL.

[in] IgnoreBuffer

Establézcalo en TRUE para omitir los búferes de usuario y forzar a que el directorio se vuelva a enumerar. Esta acción acelera la operación. Se omite si NotifyIrp es NULL.

[in] CompletionFilter

Máscara de bits de marcas que especifican los tipos de cambios en archivos o subdirectorios que deben hacer que se complete la cola de IRP de notificación pendientes. En la tabla siguiente se describen los posibles valores de marca.

Bandera Significado
FILE_NOTIFY_CHANGE_FILE_NAME (0x0001) Se ha agregado, eliminado o cambiado el nombre de un archivo en este directorio.
FILE_NOTIFY_CHANGE_DIR_NAME (0x0002) Se ha creado, quitado o cambiado el nombre de un subdirectorio.
FILE_NOTIFY_CHANGE_NAME (0x0003) El nombre de este directorio ha cambiado.
FILE_NOTIFY_CHANGE_ATTRIBUTES (0x0004) El valor de un atributo de este archivo, como la hora de último acceso, ha cambiado.
FILE_NOTIFY_CHANGE_SIZE (0x0008) El tamaño de este archivo ha cambiado.
FILE_NOTIFY_CHANGE_LAST_WRITE (0x0010) La hora de última modificación de este archivo ha cambiado.
FILE_NOTIFY_CHANGE_LAST_ACCESS (0x0020) La última hora de acceso de este archivo ha cambiado.
FILE_NOTIFY_CHANGE_CREATION (0x0040) El tiempo de creación de este archivo ha cambiado.
FILE_NOTIFY_CHANGE_EA (0x0080) Se han modificado los atributos extendidos de este archivo.
FILE_NOTIFY_CHANGE_SECURITY (0x0100) La información de seguridad de este archivo ha cambiado.
FILE_NOTIFY_CHANGE_STREAM_NAME (0x0200) Se ha agregado, eliminado o cambiado el nombre de una secuencia de archivos en este directorio.
FILE_NOTIFY_CHANGE_STREAM_SIZE (0x0400) El tamaño de esta secuencia de archivos ha cambiado.
FILE_NOTIFY_CHANGE_STREAM_WRITE (0x0800) Los datos de esta secuencia de archivos han cambiado.

completionFilter se omite si NotifyIrp es NULL.

[in, optional] NotifyIrp

Puntero al IRP para completar el cambio de notificación. Si NotifyIrp es NULL, significa que se está eliminando la secuencia de archivos representada por este objeto de archivo.

[in, optional] TraverseCallback

Puntero opcional a una rutina de devolución de llamada que se va a invocar cuando se produce un cambio en un subdirectorio que se está viendo en un árbol de directorios. Esto permite al sistema de archivos comprobar si el monitor ha recorrido el acceso a ese directorio. Esta rutina proporcionada por el autor de la llamada se declara de la siguiente manera:

NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
    IN PVOID NotifyContext,                     // FsContext
    IN PVOID TargetContext,                     // Context pointer
    IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
    );

Para obtener más información sobre el parámetro TargetContext, consulte el parámetro TargetContext de FsRtlNotifyFullReportChange. TraverseCallback se omite si NotifyIrp es NULL.

[in, optional] SubjectContext

Puntero a una estructura de SECURITY_SUBJECT_CONTEXT que se va a pasar a TraverseCallback. FsRtlNotifyFullChangeDirectory libera el contexto y libera la estructura después de usarla. Se omite si NotifyIrp es NULL. Si se proporciona una rutina de TraverseCallback, SubjectContext se pasa como parámetro SubjectContext a esa rutina.

Valor devuelto

Ninguno

Observaciones

se llama a FsRtlNotifyFullChangeDirectory un sistema de archivos que ha recibido una solicitud de cambio de notificación. Esta solicitud se recibe como IRP con código de función principal IRP_MJ_DIRECTORY_CONTROL, código de función secundaria IRP_MN_NOTIFY_CHANGE_DIRECTORY.

Si NotifyIrp es NULL, FsRtlNotifyFullChangeDirectory comprueba si la lista de notificaciones contiene un IRP pendiente que hace referencia a este objeto de archivo y, si es así, lo completa con STATUS_DELETE_PENDING.

Si NotifyIrp no es NULL, FsRtlNotifyFullChangeDirectory hace lo siguiente:

  • Comprueba si el objeto de archivo se ha realizado una limpieza. Si es así, FsRtlNotifyFullChangeDirectory completa el IRP de notificación con el estado STATUS_NOTIFY_CLEANUP.

  • Si el objeto de archivo no se ha realizado una limpieza, FsRtlNotifyFullChangeDirectory comprueba si la lista de notificaciones de este volumen ya contiene una estructura de notificación para este cambio. Si es así, FsRtlNotifyFullChangeDirectory completa los IRP pendientes. Si no es así, FsRtlNotifyFullChangeDirectory marca el IRP de notificación como pendiente, crea una estructura de notificación e la inserta en la lista.

Requisitos

Requisito Valor
de la plataforma de destino de Universal
encabezado de ntifs.h (incluya Ntifs.h)
biblioteca de NtosKrnl.lib
DLL de NtosKrnl.exe
irQL PASSIVE_LEVEL
reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT