DEVICE_DSM_NOTIFICATION_PARAMETERS Struktur (ntddstor.h)

Die DEVICE_DSM_NOTIFICATION_PARAMETERS Struktur gibt die Parameter für einen Benachrichtigungsvorgang im Zusammenhang mit den Datensatzattributen für ein Gerät an.

Syntax

typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
  ULONG Size;
  ULONG Flags;
  ULONG NumFileTypeIDs;
  GUID  FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;

Angehörige

Size

Die Gesamtgröße in Byte dieser Struktur. Der Wert dieses Elements muss die Gesamtgröße des FileTypeID- Elements in Byte enthalten.

Flags

Ein Kennzeichen, das die Merkmale des Benachrichtigungsvorgangs angibt. Das Flags Member muss auf einen der folgenden Werte festgelegt werden:

NumFileTypeIDs

Die Anzahl der Einträge im FileTypeID Member.

FileTypeID[ANYSIZE_ARRAY]

Mindestens ein GUID- Werte, die den Dateityp für den Benachrichtigungsvorgang angeben. In der folgenden Tabelle werden die FileTypeID- GUID-Werte beschrieben.

Bemerkungen

Die Benachrichtigung wird im Parameterblock innerhalb der Nutzlast einer IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES Anforderung angegeben. Eine allgemeine Beschreibung des Nutzlastlayouts finden Sie unter Data Set Management Overview.

Ab Windows 7 benachrichtigt das NTFS-Dateisystem den Speicherstapel, wenn sich der Bereich der logischen Blockadressierung (LBA) für einen bestimmten Satz von Dateien ändert. Das Dateisystem gibt diese Benachrichtigung aus, indem der Speicherstapel eine IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES Anforderung mit einem Systempuffer gesendet wird, der eine DEVICE_DSM_INPUT Struktur enthält. Für den Benachrichtigungsvorgang legt das Dateisystem die Elemente der DEVICE_DSM_INPUT Struktur wie folgt fest:

• Das Action Member ist auf DeviceDsmAction_Notificationfestgelegt.
• Die ParameterBlockOffset und ParameterBlockLength Member geben den Speicherort und die Größe des Parameterblocks für den Benachrichtigungsvorgang an. Der Parameterblock ist als DEVICE_DSM_NOTIFICATION_PARAMETERS Struktur formatiert.
• Wenn das element Flags auf Null festgelegt ist, geben die DataSetRangesOffset und DataSetRangesLength Member den Datensatzbereichsblock innerhalb der IOCTL-Nutzlast an.
• Wenn das element Flags auf DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE festgelegt ist, werden die DataSetRangesOffset- und DataSetRangesLength- elemente auf Null festgelegt, und die Benachrichtigungsaktion enthält den gesamten Datensatzbereich für die angegebenen Dateien.

Anforderungen

Siehe auch

übersicht über Data Set Management

DEVICE_DSM_ACTION Beschreibungen

DEVICE_DSM_INPUT

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES