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 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 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 IWDFDevice3 del objeto de dispositivo de marco.

[in] pWdfResourcesRaw

Puntero a la interfaz IWDFCmResourceList del 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 del 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 para casos de éxito y error de OnPrepareHardware, OnReleaseHardware debe ser capaz de controlar la limpieza de recursos parciales.

Comentarios

El método IPnpCallbackHardware2::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 el código de ejemplo en IWDFDevice3::MapIoSpace.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.11
Encabezado	wudfddi.h

Consulte también

IPnpCallbackHardware2

OnReleaseHardware