MOVE_FILE_DATA 構造体 (winioctl.h)

[アーティクル]
03/04/2024

FSCTL_MOVE_FILE 制御コードの入力データを格納します。

構文

typedef struct {
  HANDLE        FileHandle;
  LARGE_INTEGER StartingVcn;
  LARGE_INTEGER StartingLcn;
  DWORD         ClusterCount;
} MOVE_FILE_DATA, *PMOVE_FILE_DATA;

メンバー

FileHandle

移動するファイルへのハンドル。

ファイルへのハンドルを取得するには、 CreateFile を使用します。

ファイルが暗号化されている場合、ハンドルにはFILE_READ_DATA、FILE_WRITE_DATA、FILE_APPEND_DATA、またはFILE_EXECUTEアクセス権が必要です。詳細については、「ファイルのセキュリティとアクセス権」を参照してください。

StartingVcn

移動する最初のクラスターの VCN (ファイルの先頭を基準としたクラスター番号)。

StartingLcn

VCN の移動先となる LCN (ボリューム上のクラスター番号)。

ClusterCount

移動するクラスターの数。

注釈

この構造体に入力するデータを取得するには、 DeviceIoControl 関数と FSCTL_GET_RETRIEVAL_POINTERS コントロールコードを使用します。

FAT ファイルシステムボリューム上のディレクトリの最初のクラスターを移動できません。

可能なときは、互いに相対的に配置された 16 キロバイト (KB) 単位のブロックで、データを移動してください。これにより、シャドウコピーが有効になっているときのコピーオンライトのオーバーヘッドが軽減されます。これは、次の条件が発生すると、シャドウコピー領域が増大し、パフォーマンスが低下するためです。

移動要求のブロックサイズが 16 KB 以下であること。
移動の差分が 16 KB 単位ではないこと。

移動の差分は、ソースブロックの開始からターゲットブロックの開始までのバイト数です。つまり、X から Y を引いた絶対値が 16 KB の偶数倍の場合、オフセット X (ディスク上) から始まるブロックを開始オフセット Y に移動できます。そのため、4 KB クラスターを想定すると、クラスター 3 からクラスター 27 への移動は最適化されますが、クラスター 18 からクラスター 24 への移動はされません。 mod(3,4) = 3 = mod(27,4) であることに注意してください。 Mod 4 が選択されたのは、それぞれ 4 KB の 4 つのクラスターが16 KB に相当するためです。そのため、16 KB のクラスターサイズにフォーマットされたボリュームでは、すべての移動ファイルが最適化される結果になります。

シャドウコピーに関する詳細については、ボリュームシャドウコピーサービスに関する記事を参照してください。

要件

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