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 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.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 |
| Servidor mínimo compatible | Windows Server 2008 R2 |
| Encabezado | ntddstor.h (incluya Ntddstor.h) |
Consulte también
Introducción a la administración de conjuntos de datos