IoCreateStreamFileObjectLite 関数 (ntifs.h)

[アーティクル]
02/27/2024

IoCreateStreamFileObjectLite ルーチンは新しいストリームファイルオブジェクトを作成しますが、IRP_MJ_CLEANUP要求がファイルシステムドライバースタックに送信されることはありません。

構文

PFILE_OBJECT IoCreateStreamFileObjectLite(
  [in, optional] PFILE_OBJECT   FileObject,
  [in, optional] PDEVICE_OBJECT DeviceObject
);

パラメーター

[in, optional] FileObject

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

[in, optional] DeviceObject

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

戻り値

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

注釈

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

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

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

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

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

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

要件

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