Método IPnpCallbackHardware2::OnReleaseHardware (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 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 |