Función FsRtlNotifyFullReportChange (ntifs.h)

La rutina FsRtlNotifyFullReportChange completa los IRP de cambio de notificación pendientes.

Sintaxis

void FsRtlNotifyFullReportChange(
  [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
);

Parámetros

[in] NotifySync

Puntero a un objeto de sincronización opaco para el volumen actual.

[in] NotifyList

Puntero al encabezado de una lista de notificación. 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.

[in] TargetNameOffset

Desplazamiento dentro de la cadena FullTargetName del componente final del nombre.

[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 alguno 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 FsRtlNotifyFullChangeDirectory.

[in] Action

Especifica el código de acción que se va a almacenar en el búfer del usuario si está presente. El código de acción puede ser uno de los valores descritos a continuación.

Código de acción	Significado
FILE_ACTION_ADDED	Se ha creado un nuevo archivo o subdirectorio.
FILE_ACTION_REMOVED	Se ha eliminado un archivo o subdirectorio.
FILE_ACTION_MODIFIED	Se ha modificado un archivo o subdirectorio (pero no se ha creado o eliminado).
FILE_ACTION_RENAMED_OLD_NAME	Este es el nombre antiguo de un archivo cuyo nombre se ha cambiado.
FILE_ACTION_RENAMED_NEW_NAME	Este es el nuevo nombre de un archivo cuyo nombre se ha cambiado.
FILE_ACTION_ADDED_STREAM	Se ha abierto una nueva secuencia.
FILE_ACTION_REMOVED_STREAM	Se ha cerrado una secuencia.
FILE_ACTION_MODIFIED_STREAM	Se ha modificado una secuencia (pero no abierta o cerrada).
FILE_ACTION_REMOVED_BY_DELETE	Una operación de eliminación de archivo ha quitado un identificador de objeto del índice.
FILE_ACTION_ID_NOT_TUNNELLED	No se pudo tunelizar un identificador de objeto de un archivo porque su identificador de objeto coincide con el identificador de un archivo ya existente.
FILE_ACTION_TUNNELLED_ID_COLLISION	No se pudo tunelizar un identificador de objeto para un archivo porque el archivo ya tiene un identificador de objeto.

[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 FsRtlNotifyFullChangeDirectory.

Valor devuelto

None

Observaciones

Un sistema de archivos llama a FsRtlNotifyFullReportChange cuando se modifica un archivo para que se puedan completar los IRP de cambio de notificación pendientes.

FsRtlNotifyFullReportChange busca una estructura de notificación en la lista de notificaciones que coincida con el filtro y el nombre de ruta de acceso especificados. Si se encuentra una coincidencia, FsRtlNotifyFullReportChange completa todos los IRP pendientes para la estructura de notificación.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Encabezado	ntifs.h (incluya Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Reglas de cumplimiento de DDI	HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Consulte también

FsRtlNotifyFullChangeDirectory