次の方法で共有

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を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー ntmsapi.h

関連項目

NTMS_OBJECTINFORMATION