функция обратного вызова EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX (wdfdevice.h)

Статья
02/07/2025

[Применимо к KMDF и UMDF]

Функция обратного вызова событий драйвера EvtDeviceUsageNotificationEx определяет, может ли устройство поддерживать специальный тип файла.

Синтаксис

EVT_WDF_DEVICE_USAGE_NOTIFICATION_EX EvtWdfDeviceUsageNotificationEx;

NTSTATUS EvtWdfDeviceUsageNotificationEx(
  [in] WDFDEVICE Device,
  [in] WDF_SPECIAL_FILE_TYPE NotificationType,
  [in] BOOLEAN IsInNotificationPath
)
{...}

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] NotificationType

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

[in] IsInNotificationPath

Логическое значение, которое, если TRUE, указывает, что система начинает использовать специальный файл и, если FALSE, указывает, что система завершила использование специального файла.

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

Если драйвер определяет, что устройство может поддерживать специальный файл, функция обратного вызова EvtDeviceUsageNotificationEx должна возвращать STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(состояние) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (состояние) равно FALSE.

Замечания

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

Чтобы зарегистрировать функцию обратного вызова EvtDeviceUsageNotificationEx, драйвер должен вызвать WdfDeviceInitSetPnpPowerEventCallbacks.

Если функция обратного вызова драйвера EvtDeviceUsageNotificationEx возвращает состояние сбоя, платформа распространяет ошибку на другие стеки, которые могли быть уведомлены ранее.

Дополнительные сведения о специальных файлах см. в поддержке специальных файлов.

Требования

Требование	Ценность
целевая платформа	Всеобщий
минимальная версия KMDF	1.11
минимальная версия UMDF	2.0
заголовка	wdfdevice.h (include Wdf.h)
IRQL	PASSIVE_LEVEL

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