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

Статья
08/07/2023

Подпрограмма 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 , можно использовать возвращаемое значение 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 (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL