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

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

  • Статья

[Относится к 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(status) равно TRUE. В противном случае он должен возвращать значение состояния, для которого NT_SUCCESS (status) равно FALSE.

Комментарии

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

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

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

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

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1.11
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)
IRQL PASSIVE_LEVEL