Método IPnpCallbackHardware::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 notifica a un controlador que realice operaciones necesarias cuando el hardware especificado ya no sea accesible.
Sintaxis
HRESULT OnReleaseHardware(
[in] IWDFDevice *pWdfDevice
);
Parámetros
[in] pWdfDevice
Puntero a la interfaz IWDFDevice para el objeto de dispositivo del dispositivo que ya no es accesible.
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).
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.
Comentarios
Un controlador registra la interfaz IPnpCallbackHardware 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 IPnpCallbackHardback del controlador::OnPrepareHardware si OnPrepareHardware se realizó correctamente o no. Por lo tanto, OnReleaseHardware debe ser capaz de controlar la limpieza de recursos parciales.
Para obtener más información, vea Buscar y asignar recursos de hardware en un controlador UMDF.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | wudfddi.h (incluya Wudfddi.h) |
Consulte también
IPnpCallbackHardware2::OnReleaseHardware