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

Статья
12/21/2024

Подпрограмма FsRtlInsertExtraCreateParameter вставляет дополнительную структуру контекста параметра (ECP) в список ECP.

Синтаксис

NTSTATUS FsRtlInsertExtraCreateParameter(
  [in, out] PECP_LIST EcpList,
  [in, out] PVOID     EcpContext
);

Параметры

[in, out] EcpList

Указатель на структуру списка ECP, к которой должна быть добавлена структура контекста ECP, на которую указывает параметр EcpContext.

[in, out] EcpContext

Указатель на структуру контекста ECP, которую необходимо добавить в список ECP, на который указывает параметр EcpList.

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

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

Возвращаемый код	Описание
STATUS_SUCCESS	Указанная структура контекста ECP успешно вставлена в указанный список ECP.
STATUS_INVALID_PARAMETER	Указанная структура контекста ECP уже существует в указанном списке ECP. В контексте вставки списка ECP две структуры контекста ECP считаются идентичными, если они содержат равные значения GUID.

Замечания

Подпрограмма FsRtlInsertExtraCreateParameter предполагает, что указанная структура контекста ECP, которую необходимо вставить в указанный список ECP, был ранее выделен подпрограммой FltAllocateExtraCreatePara meter.

Каждая структура контекста ECP, вставленная в список ECP, должна иметь уникальное значение GUID. Это уникальное значение задается, если структура контекста ECP выделяется подпрограммой FltAllocateExtraCreateParameter.

Требования

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