Метод IPnpCallback::OnD0Entry (wudfddi.h)

Статья
03/01/2024

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод OnD0Entry уведомляет драйвер, когда устройство переходит в состояние питания D0, чтобы драйвер смог выполнить необходимые операции, такие как включение устройства.

Синтаксис

HRESULT OnD0Entry(
  [in] IWDFDevice             *pWdfDevice,
  [in] WDF_POWER_DEVICE_STATE previousState
);

Параметры

[in] pWdfDevice

Указатель на интерфейс IWDFDevice для объекта устройства, который переходит в состояние питания D0.

[in] previousState

WDF_POWER_DEVICE_STATE типизированное значение, определяющее состояние питания устройства до того, как оно перейдет в состояние питания D0.

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

Если при обратном вызове OnD0Entry не возникает ошибок, он должен возвращать S_OK или другой код состояния, для которого значение SUCCEEDED(status) равно TRUE.

Если возвращается код состояния, для которого значение SUCCEEDED(status) равно FALSE, платформа удаляет устройство. Если драйверы устройства не поддерживают другие устройства в системе, диспетчер ввода-вывода выгрузит драйверы. Платформа уведомляет диспетчер PnP, который затем пытается перезапустить устройство, запрашивая у водителя шины повторное обновление его устройств. Если драйвер был выгружен, он будет перезагружен. В этом случае платформа не будет вызывать функцию обратного вызова IPnpCallback::OnD0Exit драйвера.

Коды ошибок HRESULT определены в Winerror.h.