estructura DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)

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 siguientes valores:

Bandera	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 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 FileTypeID miembro ya no usan el intervalo LBA.

NumFileTypeIDs

Número de entradas del 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 FileTypeID GUID.

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.

Observaciones

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 de se establece en DeviceDsmAction_Notification.
• Los ParameterBlockOffset y ParameterBlockLength miembros 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 una estructura DEVICE_DSM_NOTIFICATION_PARAMETERS.
• Si el miembro Flags está establecido en cero, los miembros de DataSetRangesOffset y DataSetRangesLength especifican el bloque de intervalos del conjunto de datos dentro de la carga de IOCTL.
• Si el miembro Flags está establecido en DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, los miembros de DataSetRangesOffset y DataSetRangesLength se establecen en cero y la acción de notificación incluye todo el intervalo de conjunto de datos para los archivos especificados.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 7
servidor mínimo admitido	Windows Server 2008 R2
encabezado de	ntddstor.h (incluya Ntddstor.h)

Consulte también

Información general sobre la administración de conjuntos de datos

de descripciones de DEVICE_DSM_ACTION

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES