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

  • Статья

[Предупреждение: 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