Функция FsRtlFindExtraCreateParameter (ntifs.h)

Статья
12/21/2024

FsRtlFindExtraCreateParameter выполняет поиск заданного списка ECP для структуры контекста ECP заданного типа и возвращает указатель на эту структуру, если она найдена.

Синтаксис

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

Параметры

[in] EcpList

Указатель на структуру списка ECP, которая FsRtlFindExtraCreateParameter используется для поиска структуры контекста ECP, предоставленной параметр ом ecpType.

[in] EcpType

Указатель на GUID, однозначно определяющий структуру контекста ECP. Это значение GUID используется подпрограммой FsRtlFindExtraCreateParamter, чтобы определить, существует ли структура контекста ECP в списке ECP, предоставляемая параметром EcpList.

[out, optional] EcpContext

Необязательный параметр, который получает указатель на найденную структуру контекста ECP. Если структура контекста ECP не найдена в списке ECP, EcpContext имеет значение NULL. Если EcpContext задано значение null NULL вызывающим объектом, возвращаемое значение FsRtlFindExtraCreateParamter можно использовать для определения того, находится ли структура контекста ECP в списке ECP.

[out, optional] EcpContextSize

Необязательный параметр, получающий размер в байтах найденной структуры контекста ECP. Если структура контекста ECP не найдена, EcpContextSize равно нулю.

Возвращаемое значение

FsRtlFindExtraCreateParameter возвращает одно из следующих значений NTSTATUS:

Возвращаемый код	Описание
STATUS_SUCCESS	FsRtlFindExtraCreateParameter нашли указанную структуру контекста ECP в указанном списке ECP.
STATUS_NOT_FOUND	FsRtlFindExtraCreateParameter не нашли указанную структуру контекста ECP в указанном списке ECP.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Подпрограмма FsRtlFindExtraCreateParameter доступна начиная с Windows Vista.
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL