structure DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)

  • Article

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

DEVICE_DSM_ACTION Descriptions

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES