IoCreateStreamFileObjectEx 関数 (ntifs.h)

[アーティクル]
03/08/2023

IoCreateStreamFileObjectEx ルーチンは、新しいストリームファイルオブジェクトを作成します。

構文

PFILE_OBJECT IoCreateStreamFileObjectEx(
  [in, optional]  PFILE_OBJECT   FileObject,
  [in, optional]  PDEVICE_OBJECT DeviceObject,
  [out, optional] PHANDLE        FileHandle
);

パラメーター

[in, optional] FileObject

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

[in, optional] DeviceObject

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

[out, optional] FileHandle

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

戻り値

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

注釈

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

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

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

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

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

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

要件

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