NTMS_DRIVEINFORMATIONA 構造体 (ntmsapi.h)

  • [アーティクル]

[リムーバブル 記憶域マネージャー は、Windows 7 および Windows Server 2008 R2 以降では使用できません。

NTMS_DRIVEINFORMATION構造体は、ドライブ オブジェクトに固有のプロパティを定義します。

構文

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;

メンバー

Number

ライブラリ内のドライブの番号。 これは、デバイスのドライブ番号システムに基づいて、0 または 1 の相対値を設定します。 一部の変更者数は 0 から始まり、一部の変更者は 1 から始まります。

State

ドライブの状態。 これには、次のいずれかの値を指定できます。

値 意味
NTMS_DRIVESTATE_BEING_CLEANED
 ドライブがクリーンアップされ、使用できません。
NTMS_DRIVESTATE_DISMOUNTABLE
 遅延マウント解除用にライブラリが設定されている場合、そのメディアはライブラリのドライブのマウント解除時に残っている可能性があります。 RSM は、ロードされたドライブとマウント解除されたドライブのマウント要求を満たすことができます。
NTMS_DRIVESTATE_DISMOUNTED
 ドライブにメディアがありません。
NTMS_DRIVESTATE_LOADED
 メディアはドライブにマウントされ、読み取りおよび書き込みアクセス用に読み込まれます。
NTMS_DRIVESTATE_MOUNTED
 メディアはドライブにマウントされますが、読み取りおよび書き込みアクセスの準備ができていません。 これは、ドライブがスピンドル同期を待機している間、またはヘッド 機構にテープ メディアを読み込んでいる間に使用される一時的な状態です。
NTMS_DRIVESTATE_UNLOADED
 メディアはドライブによってマウント解除され、開く準備ができています。 この状態は、スピンドルが停止したか、テープ・メディアがテープ・カートリッジに戻されたことを示します。

DriveType

ドライブの属性を含むドライブの種類オブジェクトの一意識別子。

szDeviceName[NTMS_DEVICENAME_LENGTH]

ドライブへのアクセスに使用されるデバイスの名前。 テープ ドライブの場合、これにはデバイス名 \.\tape0 または \.\tape1 が含まれます。 その他のデバイスでは、SCSI ディスク ドライブの名前、または現在デバイスがマウントされているファイル システムのルート (生、NTFS、FAT など) が提供されます。

szSerialNumber[NTMS_SERIALNUMBER_LENGTH]

文字列として表されるドライブのシリアル番号。 シリアル番号をサポートしていないデバイスは、このメンバーの NULL を報告します。

szRevision[NTMS_REVISION_LENGTH]

文字列として表されるドライブのリビジョン。

ScsiPort

ドライブが接続されている SCSI ホスト アダプター。

ScsiBus

ドライブが接続されている SCSI バス。

ScsiTarget

ドライブの SCSI ターゲット ID。

ScsiLun

ドライブの SCSI 論理ユニット ID。

dwMountCount

ドライブにメディアが取り付けられた回数。 ドライブが一意のシリアル番号のレポートをサポートしている場合、この値はドライブがインストールされてからマウントされた回数です。 ドライブがシリアル番号のレポートをサポートしていない場合、このメンバーは、その場所にあるすべてのドライブへのマウントの数を反映します。

LastCleanedTs

前回ドライブがクリーニングされた時刻。

SavedPartitionId

ドライブ内にあるメディアのパーティション識別子。 この値が NULL で、ドライブがいっぱいであることがわかった場合、メディアはユーザーによって読み込まれ、分類する必要があります。

Library

ドライブを含むライブラリの一意識別子。

Reserved

予約済み。

dwDeferDismountDelay

遅延マウント解除が実行された後、メディアがライブラリのドライブに残る最小秒数。 既定値は 5 分です。 このメンバーは、スタンドアロン ライブラリには適用されません。 このメンバーは書き込み可能です。

注釈

NTMS_DRIVEINFORMATION構造体は、NTMS_OBJECTINFORMATION構造体に含まれています。

注意

ntmsapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてNTMS_DRIVEINFORMATIONを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header ntmsapi.h

こちらもご覧ください

NTMS_OBJECTINFORMATION