Método IPnpCallbackHardware2::OnReleaseHardware (wudfddi.h)

  • Artículo

[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 OnReleaseHardware realiza operaciones necesarias cuando un dispositivo ya no es accesible.

Sintaxis

HRESULT OnReleaseHardware(
  [in] IWDFDevice3        *pWdfDevice,
  [in] IWDFCmResourceList *pWdfResourcesTranslated
);

Parámetros

[in] pWdfDevice

Puntero a la interfaz IWDFDevice3 del objeto de dispositivo de marco.

[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

OnReleaseHardware 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).

Comentarios

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

El método OnReleaseHardware debe liberar recursos asignados durante la llamada al método IPnpCallbackHardware2::OnPrepareHardware , independientemente de si OnPrepareHardware se realizó correctamente o no. Por lo tanto, OnReleaseHardware debe ser capaz de controlar la limpieza de recursos parciales.

Para obtener información sobre cómo eliminar un objeto de interrupción, vea Eliminar un objeto de interrupción.

Para obtener información sobre cómo analizar los 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

OnPrepareHardware