次の方法で共有

FsRtlFindExtraCreateParameter 関数 (ntifs.h)

  • [アーティクル]

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 値は、FsRtlFindExtraCreateParamter ルーチンによって使用され、ECP コンテキスト構造が ECP リストに存在するかどうかを判断します。これは、EcpList パラメーターによって提供されます。

[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 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー ntifs.h (Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList の

FltCreateFileEx2 を する

FltFreeExtraCreateParameter を する

FltGetEcpListFromCallbackData の

FltInsertExtraCreateParameter の

FltRemoveExtraCreateParameter の

FltSetEcpListIntoCallbackData の

IoCreateFileEx の