FsRtlFindExtraCreateParameter 関数 (ntifs.h)

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

FsRtlFindExtraCreateParameter ルーチンは、特定の ECP リストで特定の型の ECP コンテキスト構造を検索し、見つかった場合は、この構造体へのポインターを返します。

構文

NTSTATUS FsRtlFindExtraCreateParameter(
  [in]            PECP_LIST EcpList,
  [in]            LPCGUID   EcpType,
  [out, optional] PVOID     *EcpContext,
  [out, optional] ULONG     *EcpContextSize
);

パラメーター

[in] EcpList

FsRtlFindExtraCreateParameter が ECP コンテキスト構造を検索するために使用する ECP リスト構造へのポインター。EcpType パラメーターによって提供されます。

[in] EcpType

ECP コンテキスト構造を一意に識別する GUID へのポインター。この GUID 値は、ECPList パラメーターによって提供される ECP コンテキスト構造が ECP リストに存在するかどうかを判断するために、FsRtlFindExtraCreateParamter ルーチンによって使用されます。

[out, optional] EcpContext

見つかった ECP コンテキスト構造体へのポインターを受け取る省略可能なパラメーター。 ECP コンテキスト構造が ECP リストに見つからない場合、 EcpContext は NULL に設定されます。呼び出し元によって EcpContext が NULL に設定されている場合、 FsRtlFindExtraCreateParamter の戻り値を使用して、ECP コンテキスト構造が ECP リスト内にあるかどうかを判断できます。

[out, optional] EcpContextSize

見つかった ECP コンテキスト構造のサイズをバイト単位で受け取る省略可能なパラメーター。 ECP コンテキスト構造が見つからない場合、 EcpContextSize は 0 に設定されます。

戻り値

FsRtlFindExtraCreateParameter は 、次の NTSTATUS 値のいずれかを返します。

リターンコード	説明
STATUS_SUCCESS	FsRtlFindExtraCreateParameter は、指定された ECP リストで指定された ECP コンテキスト構造を検出しました。
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter で、指定した ECP コンテキスト構造が指定された ECP リストに見つかりませんでした。

要件

要件	値
サポートされている最小のクライアント	FsRtlFindExtraCreateParameter ルーチンは、Windows Vista 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	ntifs.h (Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	<= APC_LEVEL