struktur NTMS_DRIVEINFORMATIONA (ntmsapi.h)

[ Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Struktur NTMS_DRIVEINFORMATION menentukan properti khusus untuk objek drive.

Sintaksis

typedef struct _NTMS_DRIVEINFORMATIONA {
  DWORD      Number;
  DWORD      State;
  NTMS_GUID  DriveType;
  CHAR       szDeviceName[NTMS_DEVICENAME_LENGTH];
  CHAR       szSerialNumber[NTMS_SERIALNUMBER_LENGTH];
  CHAR       szRevision[NTMS_REVISION_LENGTH];
  WORD       ScsiPort;
  WORD       ScsiBus;
  WORD       ScsiTarget;
  WORD       ScsiLun;
  DWORD      dwMountCount;
  SYSTEMTIME LastCleanedTs;
  NTMS_GUID  SavedPartitionId;
  NTMS_GUID  Library;
  GUID       Reserved;
  DWORD      dwDeferDismountDelay;
} NTMS_DRIVEINFORMATIONA;

Anggota

Number

Jumlah drive di pustaka. Ini diatur nol atau satu relatif nilai berdasarkan sistem penomoran drive perangkat. Beberapa drive nomor pengubah dimulai dengan nol, dan beberapa pengubah dimulai dengan satu.

State

Status drive. Ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
NTMS_DRIVESTATE_BEING_CLEANED	Kandar sedang dibersihkan dan tidak tersedia.
NTMS_DRIVESTATE_DISMOUNTABLE	Jika pustaka diatur untuk dilepas malas, media mungkin dibiarkan di drive pustaka pada dilepaskan. RSM dapat memenuhi permintaan pemasangan untuk drive yang dimuat dan dilepas.
NTMS_DRIVESTATE_DISMOUNTED	Tidak ada media di drive.
NTMS_DRIVESTATE_LOADED	Media dipasang di drive dan dimuat untuk akses baca dan tulis.
NTMS_DRIVESTATE_MOUNTED	Media dipasang di drive tetapi tidak siap untuk akses baca dan tulis. Ini adalah status sementara yang digunakan saat drive sedang menunggu sinkronisasi spindle atau memuat media pita ke dalam mekanisme kepala.
NTMS_DRIVESTATE_UNLOADED	Media telah dilepaskan oleh drive dan siap dibuka. Status ini menunjukkan bahwa spindle telah berhenti atau media pita telah dikembalikan ke kartrid pita.

DriveType

Pengidentifikasi unik objek jenis drive yang berisi atribut untuk drive.

szDeviceName[NTMS_DEVICENAME_LENGTH]

Nama perangkat yang digunakan untuk mengakses drive. Untuk kandar pita, ini berisi nama perangkat \.\tape0 atau \.\tape1. Perangkat lain memberikan nama drive disk SCSI atau akar sistem file yang saat ini memiliki perangkat yang dipasang (mentah, NTFS, FAT dan sebagainya).

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

Nomor seri untuk drive yang direpresentasikan sebagai string. Perangkat yang tidak mendukung nomor seri melaporkan NULL untuk anggota ini.

szRevision[NTMS_REVISION_LENGTH]

Revisi untuk drive yang diwakili sebagai string.

ScsiPort

Adaptor host SCSI tempat drive tersambung.

ScsiBus

Bus SCSI tempat drive terhubung.

ScsiTarget

ID target SCSI untuk drive.

ScsiLun

ID unit logis SCSI untuk drive.

dwMountCount

Berapa kali drive telah memiliki medium yang dipasang padanya. Jika drive mendukung pelaporan nomor seri unik, nilai ini adalah berapa kali drive telah dipasang sejak diinstal. Jika drive tidak mendukung pelaporan nomor seri, anggota ini mencerminkan jumlah pemasangan ke semua drive di lokasi tersebut.

LastCleanedTs

Terakhir kali drive dibersihkan.

SavedPartitionId

Pengidentifikasi partisi media yang ada di drive. Jika nilai ini NULL dan drive ditemukan penuh, media dimuat oleh pengguna dan perlu diklasifikasikan.

Library

Pengidentifikasi unik pustaka yang berisi drive.

Reserved

Dipesan.

dwDeferDismountDelay

Jumlah detik minimum media akan tetap berada dalam drive pustaka setelah dilepas yang ditangguhkan telah dilakukan. Defaultnya adalah 5 menit. Anggota ini tidak berlaku untuk pustaka yang berdiri sendiri. Anggota ini bisa ditulis.

Komentar

Struktur NTMS_DRIVEINFORMATION disertakan dalam struktur NTMS_OBJECTINFORMATION.

Nota

Header ntmsapi.h mendefinisikan NTMS_DRIVEINFORMATION sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	ntmsapi.h

Lihat juga

NTMS_OBJECTINFORMATION