struktur DEVICE_DSM_NOTIFICATION_PARAMETERS (ntddstor.h)
Struktur DEVICE_DSM_NOTIFICATION_PARAMETERS menentukan parameter untuk operasi pemberitahuan yang terkait dengan atribut himpunan data untuk perangkat.
Sintaks
typedef struct _DEVICE_DSM_NOTIFICATION_PARAMETERS {
ULONG Size;
ULONG Flags;
ULONG NumFileTypeIDs;
GUID FileTypeID[ANYSIZE_ARRAY];
} DEVICE_DSM_NOTIFICATION_PARAMETERS, *PDEVICE_DSM_NOTIFICATION_PARAMETERS;
Anggota
Size
Ukuran total, dalam byte, dari struktur ini. Nilai anggota ini harus menyertakan ukuran total, dalam byte, dari anggota FileTypeID .
Flags
Bendera yang menentukan karakteristik operasi pemberitahuan. Anggota Bendera harus diatur ke salah satu nilai berikut:
| Bendera | Makna |
|---|---|
| DEVICE_DSM_NOTIFY_FLAG_BEGIN | Rentang Logical Block Address (LBA) saat ini sedang digunakan oleh jenis file yang ditentukan dalam anggota FileTypeID . Rentang LBA ditentukan oleh rentang himpunan data dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . |
| DEVICE_DSM_NOTIFY_FLAG_END | Rentang LBA tidak lagi digunakan oleh jenis file yang ditentukan dalam anggota FileTypeID . |
NumFileTypeIDs
Jumlah entri dalam anggota FileTypeID .
FileTypeID[ANYSIZE_ARRAY]
Satu atau beberapa nilai GUID yang menentukan jenis file untuk operasi pemberitahuan. Tabel berikut ini menjelaskan nilai GUID FileTypeID .
| Nilai GUID | Deskripsi |
|---|---|
| FILE_TYPE_NOTIFICATION_GUID_PAGE_FILE | Menentukan operasi pemberitahuan untuk file halaman. |
| FILE_TYPE_NOTIFICATION_GUID_HIBERNATION_FILE | Menentukan operasi pemberitahuan untuk file hibernasi sistem. |
| FILE_TYPE_NOTIFICATION_GUID_CRASHDUMP_FILE | Menentukan operasi pemberitahuan untuk file crash dump sistem. |
Keterangan
Pemberitahuan ditentukan dalam blok parameter dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES . Lihat Gambaran Umum Manajemen Himpunan Data untuk deskripsi umum tata letak payload.
Dimulai dengan Windows 7, sistem file NTFS memberi tahu tumpukan penyimpanan ketika rentang kumpulan data penetapan alamat blok logis (LBA) berubah untuk sekumpulan file tertentu. Sistem file mengeluarkan pemberitahuan ini dengan mengirim tumpukan penyimpanan permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES dengan buffer sistem yang berisi struktur DEVICE_DSM_INPUT . Untuk operasi pemberitahuan, sistem file menetapkan anggota struktur DEVICE_DSM_INPUT sebagai berikut:
- Anggota Tindakan diatur ke DeviceDsmAction_Notification.
- Anggota ParameterBlockOffset dan ParameterBlockLength menentukan lokasi dan ukuran blok parameter untuk operasi pemberitahuan. Blok parameter diformat sebagai struktur DEVICE_DSM_NOTIFICATION_PARAMETERS.
- Jika anggota Bendera diatur ke nol, anggota DataSetRangesOffset dan DataSetRangesLength menentukan blok rentang himpunan data dalam payload IOCTL.
- Jika anggota Bendera diatur ke DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE, anggota DataSetRangesOffset dan DataSetRangesLength diatur ke nol dan tindakan pemberitahuan menyertakan seluruh rentang himpunan data untuk file yang ditentukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 7 |
| Server minimum yang didukung | Windows Server 2008 R2 |
| Header | ntddstor.h (termasuk Ntddstor.h) |