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

Метод 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) Платформа синхронно пересылает создание, очистку и закрытие уведомлений к следующему нижнему драйверу.

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

Никакой

Замечания

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

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

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

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

См. также

IFileCallbackCleanup::OnCleanupFile

IFileCallbackClose::OnCloseFile

IQueueCallbackCreate::OnCreateFile

IWDFDeviceInitialize

  • Last updated on