Método IPnpCallbackHardware::OnPrepareHardware (wudfddi.h)

Artículo
02/07/2025

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los nuevos controladores UMDF deben escribirse mediante 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 a UMDF.]

El método OnPrepareHardware notifica a un controlador para que el hardware especificado sea accesible.

Sintaxis

HRESULT OnPrepareHardware(
  [in] IWDFDevice *pWdfDevice
);

Parámetros

[in] pWdfDevice

Puntero a la interfaz IWDFDevice para que el objeto de dispositivo del dispositivo sea accesible.

Valor devuelto

onPrepareHardware devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h. No devuelva HRESULT_FROM_NT(STATUS_NOT_SUPPORTED).

Si onPrepareHardware devuelve un código de error, el marco seguirá llamando al método IPnpCallbackHardware::OnReleaseHardware. El método OnReleaseHardware puede liberar recursos asignados durante la llamada a OnPrepareHardware. Dado que OnReleaseHardware debe liberar recursos para los casos de éxito y error de OnPrepareHardware, debe poder controlar la limpieza de recursos parciales.

Este método debe usar la macro HRESULT_FROM_NT para devolver un valor HRESULT específico para devolver el estado a un cliente en modo kernel. Para obtener más información, consulte Compatibilidad con clientes en modo kernel.

Observaciones

Un controlador registra la interfaz IPnpCallbackHardware cuando llama al método IWDFDriver::CreateDevice para crear un objeto de dispositivo.

Recibir una llamada al método OnPrepareHardware equivale a un controlador de Microsoft Windows Driver Model (WDM) que recibe un IRP de IRP_MN_START_DEVICE.

Para obtener más información, consulte búsqueda y asignación de recursos de hardware en un controlador UMDF.