CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 構造体 (ntifs.h)

  • [アーティクル]

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT構造体には、クラスター共有ボリューム (CSV) ファイル システムに送信して、このオープン時に到着する IO を処理する方法のプロパティを設定できる追加の create パラメーター (ECP) コンテキストが含まれています。

構文

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

メンバー

Size

この構造体のサイズ (バイト単位)。

PauseTimeoutInSeconds

CSV ボリュームの一時停止が発生した場合に、このファイル オブジェクトに対して発行された IO を保留中の状態で CSVFS が保持できる秒数。 期限が切れると、CSV は、状態STATUS_CSV_IO_PAUSE_TIMEOUTでこのファイル オブジェクトに発行されたすべての IO を完了します。 このメンバーには、次のいずれかの値を指定できます。

値 意味
0xFFFFFFFF タイムアウトがないことを示し、既定の動作が要求されます。
0 CSV は IO を一時停止せず、IO をすぐに完了します。
その他の値 CSV は、他のすべての値を 10 秒の倍数に切り上げ、この値をタイムアウトとして使用します。 サポートされている最大タイムアウト値は 30 分です。 指定された値が 30 分を超える場合、CSV によって値が自動的に最大値に設定されます。

Flags

set プロパティ フラグ。 このメンバーには、次のフラグのビットごとの OR を指定できます。

フラグ 説明
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR 開いているこのファイルは調整ノードでのみ有効である必要があることを CSVFS に指示します。 オープンが CSVFS に来て、ノードが調整ノードでない場合、オープンは失敗します。 ファイルを開き、調整ノードを移動すると、開いているファイルは無効になります。 このフラグは、ファイルが CSVFS で直接開かれている場合にのみ使用され、SMB 経由でファイルが開かれた場合は無視されます。

フラグの下位 16 ビットは、CSV で認識されない場合、STATUS_INVALID_PARAMETERで作成が失敗するフラグ用です。 上の 16 ビットは、CSVFS がそれらを処理する方法を知らない場合に無視されるフラグ用です。

注釈

システム定義のGUID_ECP_CSV_SET_HANDLE_PROPERTIES値は、 FltAllocateExtraCreateParameter や FsRtlRemoveExtraCreateParameter などの ECP 関連のサポート ルーチンを呼び出すときに、この ECP コンテキスト構造で使用されます。

詳細については、「 追加の作成パラメーターの概要 」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 8
Header ntifs.h