Método IPnpCallbackHardware2::OnPrepareHardware (wudfddi.h)
[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 realiza las operaciones necesarias para que un dispositivo sea accesible para el controlador.
Sintaxis
HRESULT OnPrepareHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesRaw,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Parámetros
[in] pWdfDevice
Puntero a la interfaz de IWDFDevice3 para el objeto de dispositivo de marco.
[in] pWdfResourcesRaw
Puntero a la interfaz de IWDFCmResourceList para el objeto de lista de recursos del marco que identifica los recursos de hardware sin procesar que el administrador de Plug and Play ha asignado al dispositivo.
[in] pWdfResourcesTranslated
Puntero a la interfaz IWDFCmResourceList para el objeto de lista de recursos del marco que identifica los recursos de hardware traducidos que el administrador de Plug and Play ha asignado al dispositivo.
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 IPnpCallbackHardware2::OnReleaseHardware. El método OnReleaseHardware puede liberar recursos asignados durante la llamada a OnPrepareHardware. Dado que OnReleaseHardware debe liberar recursos tanto para casos de éxito como de error de OnPrepareHardware, OnReleaseHardware debe poder controlar la limpieza de recursos parciales.
Observaciones
El método IPnpCallbackHardbackHardware2::OnPrepareHardware difiere del método IPnpCallbackHardware::OnPrepareHardware en que recibe recursos sin procesar y traducidos.
Para obtener información sobre el análisis de recursos de hardware, consulte Búsqueda y asignación de recursos de hardware en un controlador UMDF.
Ejemplos
Vea código de ejemplo en IWDFDevice3::MapIoSpace.
Requisitos
| Requisito | Valor |
|---|---|
| fin del soporte técnico | No disponible en UMDF 2.0 y versiones posteriores. |
| de la plataforma de destino de | Escritorio |
| versión mínima de UMDF | 1.11 |
| encabezado de | wudfddi.h |