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 de 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 FileTypeID membre.
Flags
Indicateur qui spécifie les caractéristiques de l’opération de notification. Les indicateurs membre doivent être définis sur l’une des valeurs suivantes :
| Drapeau | 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 FileTypeID membre. 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 FileTypeID membre. |
NumFileTypeIDs
Nombre d’entrées dans le membre FileTypeID.
FileTypeID[ANYSIZE_ARRAY]
Un ou plusieurs GUID valeurs 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 veille prolongée 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 requête 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 de jeu de données de bloc logique (LBA) change pour un ensemble de fichiers spécifié. Le système de fichiers émet cette notification en envoyant à la pile de stockage une requête 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 DataSetRangesOffset et DataSetRangesLength membres spécifient le bloc de plage de jeux de données dans la charge utile IOCTL.
- Si le membre indicateurs de est défini sur DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, les DataSetRangesOffset et membres 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 7 |
| serveur minimum pris en charge | Windows Server 2008 R2 |
| d’en-tête | ntddstor.h (include Ntddstor.h) |
Voir aussi
Vue d’ensemble de la gestion des ensembles de données