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:
| Flagge | Bedeutung |
|---|---|
| DEVICE_DSM_NOTIFY_FLAG_BEGIN | Der LBA-Bereich (Logical Block Address) wird derzeit von den Dateitypen verwendet, die im FileTypeID Member angegeben sind. Der LBA-Bereich wird durch den Datensatzbereich innerhalb der Nutzlast einer IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES Anforderung angegeben. |
| DEVICE_DSM_NOTIFY_FLAG_END | Der LBA-Bereich wird nicht mehr von den Dateitypen verwendet, die im FileTypeID Member angegeben sind. |
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.
| GUID-Wert | Beschreibung |
|---|---|
| FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE | Gibt einen Benachrichtigungsvorgang für eine Seitendatei an. |
| FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE | Gibt einen Benachrichtigungsvorgang für die System-Ruhezustandsdatei an. |
| FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE | Gibt einen Benachrichtigungsvorgang für eine Systemabbilddatei an. |
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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| mindestens unterstützte Server- | Windows Server 2008 R2 |
| Header- | ntddstor.h (include Ntddstor.h) |
Siehe auch
übersicht über Data Set Management