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

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

Синтаксис

void FsRtlPrepareToReuseEcp(
  [in] PVOID EcpContext
);

Параметры

[in] EcpContext

Указатель на ECP для подготовки к повторному использованию.

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

None

Remarks

FsRtlPrepareToReuseEcp позволяет повторно использовать ECP, использованный в предыдущем запросе на создание. Это предотвращает инициализацию нового ECP с теми же сведениями.

Целевой объект ECP использует FsRtlAcknowledgeEcp для пометки ECP как подтвержденного. Это означает, что ECP был обнаружен и обработан. Чтобы повторно использовать ранее подтвержденную ECP, например при обработке повторного просмотра, драйвер может использовать FsRtlPrepareToReuseEcp для очистки подтвержденного состояния из ECP перед отправкой его в другом запросе на создание.

В драйвере минифильтра файловой системы используйте FltPrepareToReuseEcp для повторного использования ECP.

Требования

Требование Значение
Минимальная версия клиента Windows 8
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также раздел

ECP_LIST

FltPrepareToReuseEcp

FsRtlInsertExtraCreateParameter

FltIsEcpAcknowledged

FsRtlRemoveExtraCreateParameter