FsRtlLookupPerStreamContext マクロ (ntifs.h)
FsRtlLookupPerStreamContext マクロは、ファイル ストリームのストリームごとのコンテキスト構造を取得します。
構文
void FsRtlLookupPerStreamContext(
_sc,
_oid,
_iid
);
パラメーター
_sc
ファイル ストリームのFSRTL_ADVANCED_FCB_HEADER構造体へのポインター。 ファイル オブジェクトからこのポインターを取得するには、 FsRtlGetPerStreamContextPointer マクロを使用します。
_oid
ストリームごとのコンテキスト構造の所有者を一意に識別する呼び出し元によって割り当てられた変数へのポインター。 この変数の形式は、フィルター ドライバー固有です。 InstanceId に NULL 以外の値が指定されている場合は、NULL 以外にする必要があります。
_iid
フィルター ドライバーへのポインター - 同じフィルター ドライバーによって作成されたストリームごとのコンテキスト構造を区別するために使用できる割り当てられた変数。 この変数の形式は、フィルター ドライバー固有です。
OwnerId と InstanceId の両方が NULL の場合、FsRtlLookupPerStreamContext は見つかった最初のストリームごとのコンテキストを返します。
OwnerId に NULL 以外の値が指定され、InstanceId が NULL の場合、FsRtlLookupPerStreamContext は、OwnerId メンバーが OwnerId パラメーターと一致する最初のストリームごとのコンテキストを返します。
戻り値
なし
解説
ファイル システム フィルター ドライバーは 、FsRtlLookupPerStreamContext を呼び出して、ファイル ストリームのストリームごとのコンテキスト構造を取得します。 ストリームごとのコンテキスト構造には、フィルター ドライバーがファイル ストリームに対して保持するコンテキスト情報が含まれています。
初期化されたストリームごとのコンテキスト構造をファイル ストリームに関連付けるには、 FsRtlInsertPerStreamContext を呼び出します。
ファイル ストリームに関連付けられているストリームごとのコンテキスト構造を削除するには、 FsRtlRemovePerStreamContext を呼び出します。
詳細については、「 レガシ ファイル システム フィルター ドライバーでの Per-Stream コンテキストの追跡」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 SP4 更新プログラムのロールアップ。Windows XP |
| 対象プラットフォーム | デスクトップ |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
こちらもご覧ください
FsRtlGetPerStreamContextPointer