Метод IWDFDeviceInitialize::AutoForwardCreateCleanupClose (wudfddi.h)

Статья
02/27/2024

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод AutoForwardCreateCleanupClose управляет, когда уведомления о создании, очистке и закрытии перенаправляются в следующий нижний драйвер в стеке устройств.

Синтаксис

void AutoForwardCreateCleanupClose(
  [in] WDF_TRI_STATE State
);

Параметры

[in] State

WDF_TRI_STATE типизированное значение, определяющее состояние автоматической пересылки. В следующей таблице приводятся возможные значения.

Значение	Значение
WdfUseDefault (0)	Платформа использует схему пересылки по умолчанию. Дополнительные сведения см. в разделе "Примечания".
WdfFalse (1)	Платформа не перенаправит уведомления о создании, очистке и закрытии в следующий драйвер более низкого уровня.
WdfTrue (2)	Платформа синхронно перенаправит уведомления о создании, очистке и закрытии в следующий нижний драйвер.

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

None

Remarks

Если драйвер UMDF передает WdfUseDefault для параметра State в вызове AutoForwardCreateCleanupClose, платформа использует схему пересылки по умолчанию для уведомлений о создании, очистке и закрытии, которая зависит от того, является ли драйвер фильтром или драйвером функции:

Если драйвер является драйвером фильтра, схема пересылки по умолчанию заключается в синхронной пересылке уведомлений следующему драйверу ниже.
Если драйвер является драйвером-функцией, по умолчанию используется не переадресация уведомлений следующему драйверу ниже.

Если платформа настроена для пересылки, она пересылает уведомления о очистке и закрытии независимо от того, поддерживает ли драйвер методы интерфейса IFileCallbackCleanup::OnCleanupFile и IFileCallbackClose::OnCloseFile . Однако платформа автоматически пересылает запросы на создание, только если драйвер не поддерживает метод IQueueCallbackCreate::OnCreateFile . Если драйвер поддерживает IQueueCallbackCreate::OnCreateFile, платформа пересылает запросы на создание, только если драйвер явно настроит пересылку (WdfTrue) к следующему драйверу ниже.

Дополнительные сведения о том, как драйвер UMDF использует AutoForwardCreateCleanupClose, см. в разделе Предотвращение дисбаланса при создании и закрытии уведомлений для драйвера.

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

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

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize

Поделиться через