次の方法で共有

FltGetNextExtraCreateParameter 関数 (fltkernel.h)

  • [アーティクル]

fltGetNextExtraCreateParameter ルーチン は、指定された ECP リスト内の次の (または最初の) 追加の create パラメーター コンテキスト構造 (ECP) へのポインターを返します。

構文

NTSTATUS FLTAPI FltGetNextExtraCreateParameter(
  [in]            PFLT_FILTER Filter,
  [in]            PECP_LIST   EcpList,
  [in, optional]  PVOID       CurrentEcpContext,
  [out, optional] LPGUID      NextEcpType,
  [out, optional] PVOID       *NextEcpContext,
  [out, optional] ULONG       *NextEcpContextSize
);

パラメーター

[in] Filter

ミニフィルター ドライバーへの不透明なフィルター ポインター。 このポインターは、ミニフィルター ドライバーを一意に識別し、ミニフィルター ドライバーが読み込まれている限り一定のままになります。

[in] EcpList

調べる ECP リストへのポインター。

[in, optional] CurrentEcpContext

指定された ECP リスト内の ECP への省略可能なポインター。 存在する場合、FltGetNextExtraCreateParameter は、CurrentEcpContext ECP の後に ECP を返します。 CurrentEcpContext が NULL 場合、FltGetNextExtraCreateParameter はリスト内の最初の ECP を返します。

[out, optional] NextEcpType

返された ECP の GUID へのポインターを受け取る省略可能なパラメーター。

[out, optional] NextEcpContext

返された ECP へのポインターを受け取る省略可能なパラメーター。

[out, optional] NextEcpContextSize

返された ECP のサイズ (バイト単位) を受け取る省略可能なパラメーター。

戻り値

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

リターン コード 形容
STATUS_SUCCESS
 ECP リスト EcpList ECP が見つかりました。
STATUS_NOT_FOUND
 EcpList ECP リストが空であるか、CurrentEcpContext がリスト内の最後の ECP である、次の ECP リスト要素はありません)。 さらに、NextEcpContext NULL を に設定し、NextEcpContextSize 0 に設定します。
STATUS_INVALID_PARAMETER
 EcpList パラメーターは NULL です。

備考

このルーチンは、Windows Vista 以降で使用できます。

FltGetNextExtraCreateParameter ルーチンは、非循環方式で ECP リストを処理します。 つまり、CurrentEcpContext パラメーターが指す ECP が ECP リスト内の最後の ECP 要素である場合、リストに "next" ECP がなく、ルーチンはSTATUS_NOT_FOUNDを返します。

必要条件

要件 価値
サポートされる最小クライアント このルーチンは、Windows Vista 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fltkernel.h (Fltkernel.h を含む)
ライブラリ FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

関連項目

ECP_LIST

FltAllocateExtraCreateParameter の

FltAllocateExtraCreateParameterFromLookasideList の

FltAllocateExtraCreateParameterList の

FltCreateFileEx2 を する

FltFreeExtraCreateParameter を する

FltFreeExtraCreateParameterList を する

FltGetEcpListFromCallbackData の

FltInsertExtraCreateParameter の

FltRemoveExtraCreateParameter の

FltSetEcpListIntoCallbackData の

IoCreateFileEx の

ドライバー での GUID の使用の