struktur DEVICE_DSM_DEFINITION (ntddstor.h)

Artikel
02/26/2024

Struktur DEVICE_DSM_DEFINITION berisi properti untuk tindakan manajemen himpunan data (DSM).

Sintaks

typedef struct _DEVICE_DSM_DEFINITION {
  DEVICE_DSM_ACTION Action;
  BOOLEAN           SingleRange;
  ULONG             ParameterBlockAlignment;
  ULONG             ParameterBlockLength;
  BOOLEAN           HasOutput;
  ULONG             OutputBlockAlignment;
  ULONG             OutputBlockLength;
} DEVICE_DSM_DEFINITION, *PDEVICE_DSM_DEFINITION;

Anggota

Action

DeviceDsmDefinition_Xxx yang menentukan tindakan yang akan dilakukan. Lihat Deskripsi DEVICE_DSM_ACTION untuk daftar nilai tindakan dan nilai definisi terkait. Nilai-nilai ini didefinisikan dalam ntddstor.h.

SingleRange

Menentukan apakah tindakan DSM hanya mendukung satu rentang pada satu waktu. Jika tindakan DSM akan dilakukan pada seluruh rentang himpunan data, bendera DEVICE_DSM_FLAG_ENTIRE_DATA_SET_RANGE diatur.

ParameterBlockAlignment

Perataan untuk blok parameter dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES .

ParameterBlockLength

Panjangnya, dalam byte, dari blok parameter dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Blok parameter akan mengikuti struktur DSM_DEVICE_INPUT . Jika ParameterBlockLength diatur ke nol, maka blok parameter tidak ada.

HasOutput

Atur TRUE jika tindakan yang ditentukan dalam anggota Tindakan akan mengembalikan output; jika tidak, atur ini ke FALSE.

OutputBlockAlignment

Penyelarasan untuk blok output dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES.

OutputBlockLength

Menentukan panjang, dalam byte, dari blok output dalam payload permintaan IOCTL_STORAGE_MANAGE_DATA_SET_ATTRIBUTES. Blok output mengikuti struktur DSM_DEVICE_OUTPUT. Jika OutputBlockLength diatur ke nol, maka blok output tidak ada.

Keterangan

Setiap tindakan DSM memiliki definisi yang terkait dengannya. Misalnya, DeviceDsmAction_Trim memiliki DeviceDsmDefinition_Trim sebagai definisi terkait. Pengirim atau handler DSM mengalokasikan dan menginisialisasi struktur DEVICE_DSM_DEFINITION dengan definisi yang sesuai. Mereka kemudian meneruskan pointer ke struktur ini ke semua fungsi terkait DSM yang membutuhkannya.

Lihat Gambaran Umum Manajemen Himpunan Data untuk informasi tentang cara DSM diproses.