Método IPnpCallback::OnD0Entry (wudfddi.h)

Artículo
03/05/2024

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método OnD0Entry notifica a un controlador cuando un dispositivo entra en el estado de alimentación D0 para que el controlador pueda realizar las operaciones necesarias, como habilitar el dispositivo.

Sintaxis

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

Parámetros

[in] pWdfDevice

Puntero a la interfaz IWDFDevice para el objeto de dispositivo del dispositivo que entra en el estado de alimentación D0.

[in] previousState

Valor de tipo WDF_POWER_DEVICE_STATE que identifica el estado de alimentación del dispositivo antes de entrar en el estado de alimentación D0.

Valor devuelto

Si la devolución de llamada OnD0Entry no encuentra ningún error, debe devolver S_OK u otro código de estado para el que SUCCEEDED(status) sea igual a TRUE.

Si devuelve un código de estado para el que SUCCEEDED(status) es igual a FALSE, el marco quita el dispositivo. Si los controladores del dispositivo no admiten otros dispositivos del sistema, el administrador de E/S descarga los controladores. El marco notifica al administrador de PnP, que después intenta reiniciar el dispositivo solicitando al controlador de bus que vuelva aumer sus dispositivos. Si el controlador se ha descargado, se volverá a cargar. En este caso, el marco no llamará a la función de devolución de llamada IPnpCallback::OnD0Exit del controlador.

Los códigos de error HRESULT se definen en Winerror.h.