FSCTL_LOOKUP_STREAM_FROM_CLUSTER IOCTL (winioctl.h)

  • [アーティクル]

NTFS ボリュームへのハンドルまたは NTFS ボリューム上のファイルが指定されると、指定されたクラスターを占有するストリームを記述するデータ構造のチェーンを返します。

重要

FSCTL_LOOKUP_STREAM_FROM_CLUSTER はリソースを大量に消費する操作であり、通常は非常に大量のディスク帯域幅、メモリ、時間を使用します。 この情報の多くがキャッシュに残る可能性は低いので、 FSCTL_LOOKUP_STREAM_FROM_CLUSTERの 2 回目の呼び出しでは、最初の呼び出しとほぼ同じ時間がかかります。 複数の検索を行う場合は、 FSCTL_ENUM_USN_DATA を使用してすべての MFT レコードを列挙し、 FSCTL_GET_RETRIEVAL_POINTERS を使用してクラスターとストリーム間でマップするデータを収集する方が効率的です。

この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。

BOOL DeviceIoControl(
  (HANDLE)       hDevice,               // handle to file, directory, or volume
  FSCTL_LOOKUP_STREAM_FROM_CLUSTER,     // dwIoControlCode
  (LPVOID)       lpInBuffer,            // input buffer
  (DWORD)        nInBufferSize,         // size of input buffer
  (LPVOID)       lpOutBuffer,           // output buffer
  (DWORD)        nOutBufferSize,        // size of output buffer
  (LPDWORD)      lpBytesReturned,       // number of bytes returned
  (LPOVERLAPPED) lpOverlapped           // OVERLAPPED structure
);

解説

Windows 8 および Windows Server 2012 では、このコードは次のテクノロジでサポートされています。

テクノロジ サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル いいえ
SMB 3.0 Transparent Failover (TFO) いいえ
スケールアウト ファイル共有 (SO) を使う SMB 3.0 いいえ
クラスターの共有ボリューム ファイル システム (CsvFS) はい

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header winioctl.h (Windows.h を含む)

関連項目