FsRtlFindExtraCreateParameter 函式 (ntifs.h)

發行項
02/29/2024

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 指標。 FsRtlFindExtraCreateParamter 例程會使用此 GUID 值來判斷 ECP 內容結構是否存在於 EcpList 參數提供的 ECP 列表中。

[out, optional] EcpContext

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

[out, optional] EcpContextSize

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

傳回值

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

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

規格需求

需求	值
最低支援的用戶端	FsRtlFindExtraCreateParameter 例程可從 Windows Vista 開始提供。
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL