IoCreateStreamFileObjectEx2 関数 (ntifs.h)

[アーティクル]
07/11/2023

IoCreateStreamFileObjectEx2 ルーチンは、ターゲットデバイスオブジェクトの作成オプションを含む新しいストリームファイルオブジェクトを作成します。

構文

NTSTATUS IoCreateStreamFileObjectEx2(
  [in]            PIO_CREATE_STREAM_FILE_OPTIONS CreateOptions,
  [in, optional]  PFILE_OBJECT                   FileObject,
  [in, optional]  PDEVICE_OBJECT                 DeviceObject,
  [out]           PFILE_OBJECT                   *StreamFileObject,
  [out, optional] PHANDLE                        FileHandle
);

パラメーター

[in] CreateOptions

新しいストリームファイルオブジェクトの作成オプションを含む IO_CREATE_STREAM_FILE_OPTIONS 構造体へのポインター。

[in, optional] FileObject

新しいストリームファイルが関連付けられているファイルオブジェクトへのポインター。このパラメーターは省略可能であり、NULL にすることができます。

[in, optional] DeviceObject

ストリームファイルを開くデバイスのデバイスオブジェクトへのポインター。呼び出し元が FileObject に NULL 以外の値を指定した場合、 DeviceObject の値は無視されます。それ以外の場合、呼び出し元は DeviceObject に NULL 以外の値を指定する必要があります。

[out] StreamFileObject

ストリームファイルオブジェクトを受け取るデバイスオブジェクトポインターへのポインター。

[out, optional] FileHandle

出力時のストリームのファイルハンドルへのポインター。このパラメーターは省略可能であり、NULL にすることができます。

戻り値

IoCreateStreamFileObjectEx2 は、新しく作成されたストリームファイルオブジェクトへのポインターを返します。

注釈

ファイルシステムは IoCreateStreamFileObjectEx2 を呼び出して、新しいストリームファイルオブジェクトを作成します。 ストリームファイルオブジェクトは、FO_STREAM_FILE ファイルオブジェクトフラグが設定されている点を除き、通常のファイルオブジェクトと同じです。

ストリームファイルオブジェクトは、ファイルシステムによってマウントされたボリュームの内部ストリームを表すために一般的に使用されます。この 仮想ボリュームファイル を使用すると、ファイルシステムは、通常のファイルであるかのように、ボリュームのディスク上の構造を表示、変更、およびキャッシュできます。この場合、IoCreateStreamFileObjectEx2 の呼び出しの DeviceObject パラメーターは、ボリュームのボリュームデバイスオブジェクト (VDO) を指定します。

ストリームファイルオブジェクトを使用して、拡張属性やセキュリティ記述子など、ファイルのメタデータにアクセスするための代替データストリームを表すこともできます。この場合、IoCreateStreamFileObjectEx2 の呼び出しの FileObject パラメーターは、ファイルの既存のファイルオブジェクトを指定します。新しく作成されたストリームファイルオブジェクトを使用すると、ファイルシステムは通常のファイルのようにファイルのメタデータを表示、変更、およびキャッシュできます。

ストリームファイルオブジェクトが不要になった場合、呼び出し元は ObDereferenceObject を呼び出して参照カウントをデクリメントする必要があります。ストリームファイルオブジェクトの参照カウントが 0 に達すると、ボリュームのファイルシステムドライバースタックに IRP_MJ_CLOSE 要求が送信されます。

ファイルシステムフィルタードライバーライターは、 IoCreateStreamFileObjectEx2 によって、ボリュームのファイルシステムドライバースタックにIRP_MJ_CLEANUP要求が送信されることに注意する必要があります。ファイルシステムでは、 IRP_MJ_CREATE以外の操作の副作用としてストリームファイルオブジェクトが作成されることが多いため、フィルタードライバーがストリームファイルオブジェクトの作成を確実に検出することは困難です。したがって、フィルタードライバーは、以前に見えないファイルオブジェクトに対する IIRP_MJ_CLEANUP 要求と IRP_MJ_CLOSE 要求を受け取ることを期待する必要があります。

プール割り当てエラーが発生した場合、 IoCreateStreamFileObjectEx2 は STATUS_INSUFFICIENT_RESOURCES 例外を発生させます。

要件

要件	値
サポートされている最小のクライアント	Windows 8
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE