FsRtlRemoveExtraCreateParameter 関数 (ntifs.h)

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

FsRtlRemoveExtraCreateParameter ルーチンは ECP リストで ECP コンテキスト構造を検索し、見つかった場合は ECP リストからデタッチします。

構文

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

パラメーター

[in, out] EcpList

指定されたリストからデタッチされる ECP コンテキスト構造を含む追加の create パラメーター (ECP) リストへのポインター。

[in] EcpType

一覧からデタッチする ECP コンテキスト構造を一意に識別する GUID へのポインター。

[out] EcpContext

デタッチされた ECP コンテキスト構造へのポインター。指定されたリストから ECP コンテキスト構造が正常にデタッチされた場合、このパラメーターはデタッチされた ECP コンテキスト構造を指すよう設定されます。指定された ECP リストに ECP コンテキスト構造が見つからない場合、このパラメーターは NULL に設定されます。

[out, optional] EcpContextSize

デタッチされた ECP コンテキスト構造のサイズを受け取る省略可能なパラメーター。ルーチンの呼び出し時にこのパラメーターが存在する場合、パラメーターはデタッチされた ECP コンテキスト構造のサイズ (バイト単位) を受け取ります。指定された ECP コンテキスト構造が指定された ECP リストに見つからなかった場合、このパラメーターは未定義です。

戻り値

FsRtlRemoveExtraCreateParameter は、次のいずれかの NTSTATUS コードを返します。

リターンコード	説明
STATUS_SUCCESS	指定された ECP コンテキスト構造が、指定された ECP リストから正常にデタッチされました。
STATUS_NOT_FOUND	指定された ECP コンテキスト構造が、指定された ECP リストに見つかりませんでした。

注釈

FsRtlRemoveExtraCreateParameter ルーチンは、EcpList パラメーターによって指定された ECP リストを検索し、EcpType パラメーターによって指定された ECP コンテキスト構造を検索します。 ECP コンテキスト構造がリストに存在する場合、 FsRtlRemoveExtraCreateParameter は 構造体をリストからデタッチし、 EcpContext パラメーターを構造体を指すように設定し、STATUS_SUCCESSを返します。 ECP コンテキスト構造がリストに存在しない場合、 FsRtlRemoveExtraCreateParameter は EcpContext パラメーターを NULL に設定し、STATUS_NOT_FOUNDを返します。

注意

FsRtlRemoveExtraCreateParameter は、ECP コンテキスト構造のメモリプールを解放しません。 ECP コンテキスト構造のメモリプールを解放するには、まず FsRtlRemoveExtraCreateParameter を呼び出してリストからデタッチし、 FltFreeExtraCreateParameter ルーチンを呼び出して ECP コンテキスト構造のメモリプールを解放します。

要件

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