VOLUME_BITMAP_BUFFER 構造体 (winioctl.h)

  • [アーティクル]

ディスク上の占有クラスターと使用可能なクラスターを表します。 この構造体は、 FSCTL_GET_VOLUME_BITMAP コントロール コードの出力バッファーです。

構文

typedef struct {
  LARGE_INTEGER StartingLcn;
  LARGE_INTEGER BitmapSize;
  BYTE          Buffer[1];
} VOLUME_BITMAP_BUFFER, *PVOLUME_BITMAP_BUFFER;

メンバー

StartingLcn

操作への入力として要求された LCN を開始します。

BitmapSize

この構造体の StartingLcn メンバーで返された開始 LCN から始まる、ボリューム上のクラスターの数。 詳細については、次の「解説」セクションを参照してください。

Buffer[1]

操作によって返されるビットマップを含むバイトの配列。 ビットマップは、ビットマップのビット 0 から末尾までビットごとのです。 したがって、要求されたクラスターから開始すると、ビットマップはバイト 0 のビット 0、バイト 0 のビット 1 から取得されます。バイト 0 のビット 7、バイト 1 のビット 0 など。 値 1 は、クラスターが割り当てられている (使用中) ことを示します。 値 0 は、クラスターが (空き) 割り当てされていないことを示します。

注釈

BitmapSize メンバーは、この構造体の StartingLcn メンバーで返される開始 LCN から始まる、ボリューム上のクラスターの数です。 たとえば、ボリュームに0xD3F7クラスターがあるとします。 LCN 0xA007でビットマップ クエリを開始すると、FAT ファイル システムと NTFS ファイル システムの両方で、返された開始 LCN が LCN 0xA000に切り捨てられます。 BitmapSize メンバーで返される値は (0xD3F7 – 0xA000)、または0x33F7になります。

要件

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

こちらもご覧ください

最適化

FSCTL_GET_VOLUME_BITMAP