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) |