RETRIEVAL_POINTERS_BUFFER 構造体 (winioctl.h)

  • [アーティクル]

FSCTL_GET_RETRIEVAL_POINTERS 制御コードの出力を格納します。

構文

typedef struct RETRIEVAL_POINTERS_BUFFER {
  DWORD                    ExtentCount;
  LARGE_INTEGER            StartingVcn;
  struct {
    LARGE_INTEGER NextVcn;
    LARGE_INTEGER Lcn;
  };
  __unnamed_struct_1932_64 Extents[1];
} RETRIEVAL_POINTERS_BUFFER, *PRETRIEVAL_POINTERS_BUFFER;

メンバー

ExtentCount

Extents 配列内の要素の数。

StartingVcn

関数呼び出しによって返される開始 VCN。 これは、関数呼び出しによって要求された VCN とは限りません。ファイル システム ドライバーは、要求された開始 VCN が見つかったエクステントの最初の VCN に切り捨てられます。

NextVcn

Lcn

Extents[1]

エクステント構造体 の 配列。 配列内のメンバーの数については、「 ExtentCount」を参照してください。 配列の各メンバーには、次のメンバーがあります。

NextVcn

次のエクステントが開始される VCN。 この値から StartingVcn (最初の Extents 配列メンバーの場合) または配列の前のメンバーの NextVcn (他のすべての Extents 配列メンバーの場合) を引いた値は、現在のエクステントの長さ (クラスター内) です。 長さは、 FSCTL_MOVE_FILE 操作への入力です。

Lcn

現在のエクステントがボリュームで開始される LCN。 この値は、 FSCTL_MOVE_FILE 操作への入力です。 NTFS ファイル システムでは、値 (LONGLONG) –1 は、部分的に割り当てられた圧縮単位か、スパース ファイルの未割り当て領域のいずれかを示します。

要件

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

こちらもご覧ください

最適化

FSCTL_GET_RETRIEVAL_POINTERS

FSCTL_MOVE_FILE