Función FsRtlNotifyFilterReportChange (ntifs.h)

FsRtlNotifyFilterReportChange completa IRP_MN_NOTIFY_CHANGE_DIRECTORY solicitudes pendientes en la lista de notificaciones especificada.

Sintaxis

void FsRtlNotifyFilterReportChange(
  [in]           PNOTIFY_SYNC NotifySync,
  [in]           PLIST_ENTRY  NotifyList,
  [in]           PSTRING      FullTargetName,
  [in]           USHORT       TargetNameOffset,
  [in, optional] PSTRING      StreamName,
  [in, optional] PSTRING      NormalizedParentName,
  [in]           ULONG        FilterMatch,
  [in]           ULONG        Action,
  [in, optional] PVOID        TargetContext,
  [in, optional] PVOID        FilterContext
);

Parámetros

[in] NotifySync

Puntero a un objeto de sincronización opaco para la lista de notificación del directorio de cambios a la que apunta el parámetro NotifyList .

[in] NotifyList

Puntero al encabezado de la lista de notificaciones del directorio de cambios para el volumen actual. Cada elemento de la lista es una estructura de notificación opaca.

[in] FullTargetName

Puntero a una cadena ANSI o Unicode que contiene el nombre de ruta de acceso completo del archivo o directorio que cambió.

[in] TargetNameOffset

Desplazamiento, en bytes, dentro de la cadena FullTargetName del componente final del nombre de archivo para el archivo o directorio que cambió.

[in, optional] StreamName

Puntero opcional a una cadena ANSI o Unicode que contiene un nombre de secuencia que se va a almacenar con el nombre de archivo.

[in, optional] NormalizedParentName

Puntero opcional a una cadena ANSI o Unicode que contiene la misma ruta de acceso que en la cadena FullTargetName , pero con todos los nombres cortos reemplazados por los nombres largos correspondientes.

[in] FilterMatch

Máscara de bits de marcas que se van a comparar con el filtro de finalización de la estructura de notificación. Si se establece cualquiera de los bits correspondientes en el filtro de finalización, existe una condición de notificación. Para conocer los posibles valores de marca, consulte el parámetro CompletionFilter de FsRtlNotifyFilterChangeDirectory.

[in] Action

Especifica el código de acción que se va a almacenar en el búfer del usuario si está presente. Para conocer los posibles valores de código de acción, consulte el parámetro Action de FsRtlNotifyFullReportChange.

[in, optional] TargetContext

Puntero de contexto que se va a pasar al sistema de archivos si se realiza una comprobación de recorrido en el caso de que se vea un árbol. Para obtener más información, vea el parámetro TraverseCallback de FsRtlNotifyFilterChangeDirectory.

[in, optional] FilterContext

Puntero de contexto que se va a pasar a la rutina de devolución de llamada de filtro. Para obtener más información, vea el parámetro FilterCallback de FsRtlNotifyFilterChangeDirectory.

Valor devuelto

None

Observaciones

Un sistema de archivos que ha recibido un IRP con código de función principal IRP_MJ_DIRECTORY_CONTROL, código de función secundaria IRP_MN_NOTIFY_CHANGE_DIRECTORY, llama a FsRtlNotifyFilterChangeDirectory para crear una estructura de notificación que contenga el IRP y agregue la estructura de notificación a la lista de notificaciones para el volumen actual.

Cuando se produce un cambio en el directorio, el sistema de archivos llama a FsRtlNotifyFilterReportChange para completar las solicitudes de IRP_MN_NOTIFY_CHANGE_DIRECTORY pendientes en la lista de notificaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Paquete acumulativo de actualizaciones de Windows 2000 SP4; Windows XP
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	< APC_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FsRtlNotifyFilterChangeDirectory

FsRtlNotifyFullChangeDirectory

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL