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

[ предупреждение: 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.

Замечания

Драйвер регистрирует интерфейс IPnpCallback при вызове метода IWDFDriver::CreateDevice для создания объекта устройства.

Требования

См. также

IPnpCallback

IWDFDevice

IWDFDriver::CreateDevice

WDF_POWER_DEVICE_STATE