次の方法で共有


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 を返します。 CurrentEcpContextNULL の場合、FltGetNextExtraCreateParameter はリスト内の最初の ECP を返します。

[out, optional] NextEcpType

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

[out, optional] NextEcpContext

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

[out, optional] NextEcpContextSize

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

戻り値

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

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

注釈

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

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

要件

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

こちらもご覧ください

ECP_LIST

FltAllocateExtraCreateParameter

FltAllocateExtraCreateParameterFromLookasideList

FltAllocateExtraCreateParameterList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltFreeExtraCreateParameterList

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx

ドライバーでの GUID の使用