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

Функция WdfDeviceIndicateWakeStatus (wdfdevice.h)

  • Статья

[Применяется только к KMDF]

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

Синтаксис

NTSTATUS WdfDeviceIndicateWakeStatus(
  [in] WDFDEVICE Device,
  [in] NTSTATUS  WaitWakeStatus
);

Параметры

[in] Device

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

[in] WaitWakeStatus

Значение состояния NTSTATUS. Если устройство активировало сигнал пробуждения, вызывающий объект должен задать для этого значения значение STATUS_SUCCESS или другое значение состояния, для которого NT_SUCCESS(WaitWakeStatus) равно TRUE. Если устройство не активировало сигнал пробуждения или была обнаружена ошибка, вызывающий объект должен предоставить значение состояния, для которого NT_SUCCESS(WaitWakeStatus) равно FALSE. Дополнительные сведения см. в разделе "Примечания".

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

Если операция выполнена успешно, WdfDeviceIndicateWakeStatus возвращает STATUS_SUCCESS. К дополнительным возвращаемым значениям относятся:

Код возврата Описание
STATUS_INVALID_PARAMETER
 WaitWakeStatus имеет значение STATUS_PENDING или STATUS_CANCELLED.
STATUS_INVALID_DEVICE_REQUEST
 В стеке драйверов не настроено ожидание, пока устройство запустит сигнал пробуждения.
STATUS_INVALID_DEVICE_STATE
 Вызывающий драйвер не несет ответственности за ожидание срабатывания сигнала пробуждения устройства.
 

Метод может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Комментарии

Если NT_SUCCESS (WaitWakeStatus) равно TRUE, платформа восстановит рабочее состояние устройства и системы. Если значение NT_SUCCESS(WaitWakeStatus) равно FALSE, устройство и система останутся в текущем состоянии.

Дополнительные сведения о вызове метода WdfDeviceIndicateWakeStatus см. в разделе Поддержка пробуждения системы.

Примеры

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

NTSTATUS  status;

status = WdfDeviceIndicateWakeStatus(
                                     hChild,
                                     STATUS_SUCCESS
                                     );

Требования

Требование Значение
Целевая платформа Универсальное
Минимальная версия KMDF 1,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL <= DISPATCH_LEVEL
Правила соответствия DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)