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 呼び出して、ファイル ストリームのストリームごとのコンテキスト構造を取得します。 ストリームごとのコンテキスト構造には、ファイル ストリームのフィルター ドライバーが保持するコンテキスト情報が含まれています。
注FsRtlLookupPerStreamContext は、ストリームごとのコンテキストをサポートするファイル システムでのみ使用できます。
初期化されたストリームごとのコンテキスト構造をファイル ストリームに関連付けるには、FsRtlInsertPerStreamContext 呼び出します。
ファイル ストリームに関連付けられているストリームごとのコンテキスト構造を削除するには、FsRtlRemovePerStreamContext 呼び出します。
詳細については、「レガシ ファイル システム フィルター ドライバー の追跡 Per-Stream コンテキスト」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 SP4 更新プログラムのロールアップ。Windows XP |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | ntifs.h (Ntifs.h を含む) |
| ライブラリ | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |
関連項目
FsRtlGetPerStreamContextPointer の
FsRtlSetupAdvancedHeader の