共用方式為


FsRtlFindExtraCreateParameter 函式 (ntifs.h)

FsRtlFindExtraCreateParameter 例程會搜尋指定類型的 ECP 內容結構清單,並在找到時傳回此結構的指標。

語法

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

參數

[in] EcpList

FsRtlFindExtraCreateParameter 用來搜尋由 EcpType 參數提供之 ECP 內容結構的 ECP 清單結構的指標。

[in] EcpType

可唯一識別 ECP 內容結構的 GUID 指標。 FsRtlFindExtraCreateParamter 例程會使用此 GUID 值,以判斷 ECP 內容結構是否存在於 ECP 清單中,EcpList 參數提供。

[out, optional] EcpContext

選擇性參數,可接收找到ECP內容結構的指標。 如果在 ECP 清單中找不到 ECP 內容結構,EcpContext 設定為 NULL。 如果呼叫者將 EcpContext 設為 NULL,則 FsRtlFindExtraCreateParamter 的傳回值 可用來判斷 ECP 內容結構是否位於 ECP 清單中。

[out, optional] EcpContextSize

選擇性參數,接收所找到 ECP 內容結構的大小,以位元組為單位。 如果找不到ECP內容結構,EcpContextSize 設定為零。

傳回值

FsRtlFindExtraCreateParameter 會傳回下列其中一個 NTSTATUS 值:

傳回碼 描述
STATUS_SUCCESS
FsRtlFindExtraCreateParameter 在指定的 ECP 清單中找到指定的 ECP 內容結構。
STATUS_NOT_FOUND
FsRtlFindExtraCreateParameter 在指定的 ECP 清單中找不到指定的 ECP 內容結構。

要求

要求 價值
最低支援的用戶端 從 Windows Vista 開始,即可使用 FsRtlFindExtraCreateParameter 例程。
目標平臺 普遍
標頭 ntifs.h (include Ntifs.h)
連結庫 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另請參閱

ECP_LIST

FltAllocateExtraCreateParameterFromLookasideList

FltCreateFileEx2

FltFreeExtraCreateParameter

FltGetEcpListFromCallbackData

FltInsertExtraCreateParameter

FltRemoveExtraCreateParameter

FltSetEcpListIntoCallbackData

IoCreateFileEx