estructura DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)

Artículo
08/07/2023

La estructura DEVICE_DSM_NOTIFICATION_PARAMETERS especifica los parámetros de una operación de notificación relacionada con los atributos del conjunto de datos para un dispositivo.

Sintaxis

typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
  ULONG Size;
  ULONG Flags;
  ULONG NumFileTypeIDs;
  GUID  FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;

Miembros

Size

Tamaño total, en bytes, de esta estructura. El valor de este miembro debe incluir el tamaño total, en bytes, del miembro FileTypeID .

Flags

Marca que especifica las características de la operación de notificación. El miembro Flags debe establecerse en uno de los valores siguientes:

Marca	Significado
DEVICE_DSM_NOTIFY_FLAG_BEGIN	El intervalo de direcciones de bloque lógico (LBA) está siendo utilizado actualmente por los tipos de archivo que se especifican en el miembro FileTypeID . El intervalo de LBA se especifica mediante el intervalo del conjunto de datos dentro de la carga de una solicitud de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .
DEVICE_DSM_NOTIFY_FLAG_END	Los tipos de archivo especificados en el miembro FileTypeID ya no usan el intervalo LBA.

NumFileTypeIDs

Número de entradas en el miembro FileTypeID .

FileTypeID[ANYSIZE_ARRAY]

Uno o varios valores GUID que especifican el tipo de archivo para la operación de notificación. En la tabla siguiente se describen los valores guid de FileTypeID .

Valor GUID	Descripción
FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE	Especifica una operación de notificación para un archivo de página.
FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE	Especifica una operación de notificación para el archivo de hibernación del sistema.
FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE	Especifica una operación de notificación para un archivo de volcado de memoria del sistema.

Comentarios

La notificación se especifica en el bloque de parámetros dentro de la carga de una solicitud de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Consulte Información general sobre la administración de conjuntos de datos para obtener una descripción general del diseño de la carga.

A partir de Windows 7, el sistema de archivos NTFS notifica a la pila de almacenamiento cuando el intervalo de conjuntos de datos de direccionamiento de bloques lógicos (LBA) cambia para un conjunto especificado de archivos. El sistema de archivos emite esta notificación enviando a la pila de almacenamiento una solicitud de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES con un búfer del sistema que contiene una estructura de DEVICE_DSM_INPUT . Para la operación de notificación, el sistema de archivos establece los miembros de la estructura DEVICE_DSM_INPUT de la siguiente manera:

El miembro Action se establece en DeviceDsmAction_Notification.
Los miembros ParameterBlockOffset y ParameterBlockLength especifican la ubicación y el tamaño del bloque de parámetros para la operación de notificación. El bloque de parámetros tiene el formato de estructura DEVICE_DSM_NOTIFICATION_PARAMETERS.
Si el miembro Flags se establece en cero, los miembros DataSetRangesOffset y DataSetRangesLength especifican el bloque de intervalos del conjunto de datos dentro de la carga de IOCTL.
Si el miembro Flags se establece en DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, los miembros DataSetRangesOffset y DataSetRangesLength se establecen en cero y la acción de notificación incluye todo el intervalo de conjuntos de datos para los archivos especificados.