次の方法で共有


FSCTL_OFFLOAD_WRITE_OUTPUT構造体 (ntifs.h)

FSCTL_OFFLOAD_WRITE_OUTPUT 構造体には、FSCTL_OFFLOAD_WRITE 制御コード要求の出力が含まれています。

構文

typedef struct _FSCTL_OFFLOAD_WRITE_OUTPUT {
  ULONG     Size;
  ULONG     Flags;
  ULONGLONG LengthWritten;
} FSCTL_OFFLOAD_WRITE_OUTPUT, *PFSCTL_OFFLOAD_WRITE_OUTPUT;

メンバーズ

Size

この構造体のサイズ (バイト単位)。 このメンバーを sizeof(FSCTL_OFFLOAD_WRITE_OUTPUT)に設定します。

Flags

オフロード書き込み操作の結果フラグ。 この値は 0 または次のいずれかです。

価値 意味
OFFLOAD_READ_FLAG_FILE_TOO_SMALL 書き込むファイルが、オフロード操作には小さすぎます。

LengthWritten

FSCTL_OFFLOAD_WRITE_INPUTで指定された転送用に書き込まれたデータの長さ。

備考

書き込まれた結果の長さ (LengthWritten ) は、FSCTL_OFFLOAD_WRITE_INPUTCopyLength メンバーで最初に指定されたものより小さい場合があります。 値が小さいほど、指定した トークンを使用して論理的に書き込めるデータが、要求されたデータよりも少 ことを示します。

要求されたデータよりも少ないデータが書き込まれた場合は、別の FSCTL_OFFLOAD_WRITE 要求を実行して書き込み操作を完了できます。 次の要求では、FSCTL_OFFLOAD_WRITE_INPUT 構造体の更新された FileOffset メンバーが使用され、lengthWritten の値と、前の長さの調整された書き込み長さから LengthWritten の値引いた値が使用されます。 たとえば、ZwWriteFile ルーチンを使用するなど、オフロードされていない書き込みメソッドを使用して、不完全な書き込み操作を完了することもできます。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
ヘッダー ntifs.h (Ntifs.h、Fltkernel.h を含む)

関連項目

FSCTL_OFFLOAD_WRITE

FSCTL_OFFLOAD_WRITE_INPUT