structure DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)
La structure DEVICE_DSM_NOTIFICATION_PARAMETERS spécifie les paramètres d’une opération de notification liée aux attributs du jeu de données d’un appareil.
Syntaxe
typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
ULONG Size;
ULONG Flags;
ULONG NumFileTypeIDs;
GUID FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;
Membres
Size
Taille totale, en octets, de cette structure. La valeur de ce membre doit inclure la taille totale, en octets, du membre FileTypeID .
Flags
Indicateur qui spécifie les caractéristiques de l’opération de notification. Le membre Flags doit être défini sur l’une des valeurs suivantes :
| Indicateur | Signification |
|---|---|
| DEVICE_DSM_NOTIFY_FLAG_BEGIN | La plage d’adresses de bloc logique (LBA) est actuellement utilisée par les types de fichiers spécifiés dans le membre FileTypeID . La plage LBA est spécifiée par la plage de jeu de données dans la charge utile d’une requête IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . |
| DEVICE_DSM_NOTIFY_FLAG_END | La plage LBA n’est plus utilisée par les types de fichiers spécifiés dans le membre FileTypeID . |
NumFileTypeIDs
Nombre d’entrées dans le membre FileTypeID .
FileTypeID[ANYSIZE_ARRAY]
Une ou plusieurs valeurs GUID qui spécifient le type de fichier pour l’opération de notification. Le tableau suivant décrit les valeurs GUID FileTypeID .
| Valeur GUID | Description |
|---|---|
| FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE | Spécifie une opération de notification pour un fichier de page. |
| FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE | Spécifie une opération de notification pour le fichier de mise en veille prolongée du système. |
| FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE | Spécifie une opération de notification pour un fichier de vidage sur incident système. |
Remarques
La notification est spécifiée dans le bloc de paramètres dans la charge utile d’une demande de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Consultez Vue d’ensemble de la gestion des ensembles de données pour obtenir une description générale de la disposition de la charge utile.
À compter de Windows 7, le système de fichiers NTFS avertit la pile de stockage lorsque la plage de jeu de données d’adressage de blocs logiques (LBA) change pour un ensemble de fichiers spécifié. Le système de fichiers émet cette notification en envoyant à la pile de stockage une demande de IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES avec une mémoire tampon système qui contient une structure DEVICE_DSM_INPUT . Pour l’opération de notification, le système de fichiers définit les membres de la structure DEVICE_DSM_INPUT comme suit :
- Le membre Action est défini sur DeviceDsmAction_Notification.
- Les membres ParameterBlockOffset et ParameterBlockLength spécifient l’emplacement et la taille du bloc de paramètres pour l’opération de notification. Le bloc de paramètres est mis en forme en tant que structure DEVICE_DSM_NOTIFICATION_PARAMETERS.
- Si le membre Flags a la valeur zéro, les membres DataSetRangesOffset et DataSetRangesLength spécifient le bloc de plage de jeux de données dans la charge utile IOCTL.
- Si le membre Flags est défini sur DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, les membres DataSetRangesOffset et DataSetRangesLength sont définis sur zéro et l’action de notification inclut l’ensemble de la plage de jeux de données pour les fichiers spécifiés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 |
| Serveur minimal pris en charge | Windows Server 2008 R2 |
| En-tête | ntddstor.h (inclure Ntddstor.h) |
Voir aussi
Vue d’ensemble de la gestion des ensembles de données