struktur DEVICE_MANAGE_DATA_SET_ATTRIBUTES (winioctl.h)

  • Artikel

Struktur input untuk kode kontrol IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

Sintaks

typedef struct _DEVICE_MANAGE_DATA_SET_ATTRIBUTES {
  DWORD             Size;
  DEVICE_DSM_ACTION Action;
  DWORD             Flags;
  DWORD             ParameterBlockOffset;
  DWORD             ParameterBlockLength;
  DWORD             DataSetRangesOffset;
  DWORD             DataSetRangesLength;
} DEVICE_MANAGE_DATA_SET_ATTRIBUTES, *PDEVICE_MANAGE_DATA_SET_ATTRIBUTES, DEVICE_DSM_INPUT, *PDEVICE_DSM_INPUT;

Anggota

Size

Ukuran struktur data ini. Harus diatur ke sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES).

Action

Nilai jenis DEVICE_DATA_MANAGEMENT_SET_ACTION yang valid.

Nilai Makna
DeviceDsmAction_Trim
1
 Tindakan pemangkasan dilakukan. Nilai ini tidak didukung untuk aplikasi mode pengguna.
DeviceDsmAction_Notification
2 | DeviceDsmActionFlag_NonDestructive (0x80000002)
 Tindakan pemberitahuan dilakukan. Parameter tambahan berada dalam struktur DEVICE_DSM_NOTIFICATION_PARAMETERS . DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.
DeviceDsmAction_OffloadRead
3 | DeviceDsmActionFlag_NonDestructive (0x80000003)
 Tindakan baca offload dilakukan. Parameter tambahan berada dalam struktur DEVICE_DSM_OFFLOAD_READ_PARAMETERS . DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.
DeviceDsmAction_OffloadWrite
4
 Tindakan tulis offload dilakukan. Parameter tambahan berada dalam struktur DEVICE_DSM_OFFLOAD_WRITE_PARAMETERS .

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.
DeviceDsmAction_Allocation
5 | DeviceDsmActionFlag_NonDestructive (0x80000005)
 Bitmap alokasi diambil untuk rentang himpunan data pertama yang ditentukan. DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.
DeviceDsmAction_Repair
6 | DeviceDsmActionFlag_NonDestructive (0x80000006)
 Tindakan perbaikan dilakukan. Parameter tambahan berada dalam struktur DEVICE_DATA_SET_REPAIR_PARAMETERS . DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.
DeviceDsmAction_Scrub
7 | DeviceDsmActionFlag_NonDestructive (0x80000007)
 Tindakan scrub dilakukan. DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.
DeviceDsmAction_Resiliency
8 | DeviceDsmActionFlag_NonDestructive (0x80000008)
 Tindakan ketahanan dilakukan. DeviceDsmActionFlag_NonDestructive (0x80000000) adalah bendera bit untuk menunjukkan ke tumpukan driver bahwa operasi ini tidak merusak.

Windows 7 dan Windows Server 2008 R2: Nilai ini tidak didukung sebelum Windows 8 dan Windows Server 2012.

Flags

Bendera untuk tindakan.

Nilai Makna
DEVICE_DSM_FLAG_TRIM_NOT_FS_ALLOCATED
0x80000000
 Jika diatur maka rentang yang dijelaskan tidak dialokasikan oleh sistem file. Bendera ini khusus untuk tindakan DeviceDsmAction_Trim .
DEVICE_DSM_FLAG_RESILIENCY_START_RESYNC
0x10000000
 Memulai operasi sinkronisasi ulang pada perangkat penyimpanan. Bendera ini khusus untuk tindakan DeviceDsmAction_Resiliency .
DEVICE_DSM_FLAG_RESILIENCY_START_LOAD_BALANCING
0x20000000
 Memulai operasi penyeimbangan beban pada perangkat penyimpanan. Bendera ini khusus untuk tindakan DeviceDsmAction_Resiliency .

ParameterBlockOffset

Byte offset ke awal blok parameter yang disimpan dalam buffer yang berdampingan dengan struktur ini. Harus diselaraskan dengan perataan struktur yang sesuai. Nilai nol menunjukkan tidak ada blok parameter dan anggota ParameterBlockLength juga harus nol.

ParameterBlockLength

Panjang blok parameter, dalam byte. Nilai nol menunjukkan tidak ada blok parameter dan anggota ParameterBlockOffset juga harus nol.

DataSetRangesOffset

Byte offset ke awal blok rentang himpunan data yang terdiri dari array struktur DEVICE_DATA_SET_RANGE yang disimpan dalam buffer yang berdampingan dengan struktur ini. Harus diratakan ke perataan struktur DEVICE_DATA_SET_RANGE . Nilai nol menunjukkan tidak ada blok rentang himpunan data dan anggota DataSetRangesLength juga harus nol.

DataSetRangesLength

Panjang blok rentang himpunan data, dalam byte. Nilai nol menunjukkan tidak ada blok rentang himpunan data dan anggota DataSetRangesOffset juga harus nol.

Keterangan

Panjang total buffer yang berisi struktur ini harus setidaknya (sizeof(DEVICE_MANAGE_DATA_SET_ATTRIBUTES) + ParameterBlockLength + DataSetRangesLength).

Persyaratan

   
Klien minimum yang didukung Windows 7
Server minimum yang didukung Windows Server 2008 R2
Header winioctl.h (termasuk Windows.h)

Lihat juga

DEVICE_DATA_SET_RANGE

Struktur Manajemen Perangkat

IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES