Método IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval (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.

Una función de devolución de llamada de eventos OnRemoteInterfaceRemoval del controlador basado en UMDF notifica al controlador que no puede usar una interfaz de dispositivo porque se ha quitado la interfaz.

Sintaxis

void OnRemoteInterfaceRemoval(
  [in] IWDFRemoteInterface *pWdfRemoteInterface
);

Parámetros

[in] pWdfRemoteInterface

Puntero a la interfaz IWDFRemoteInterface de un objeto de interfaz remota que representa una interfaz de dispositivo. El controlador obtiene este puntero cuando llama a IWDFDevice2::CreateRemoteInterface.

Valor devuelto

None

Observaciones

La función de devolución de llamada de eventos OnRemoteInterfaceRemoval de un controlador debe realizar las tareas específicas del controlador para controlar la eliminación de la interfaz del dispositivo. Además, la devolución de llamada debe eliminar el objeto de interfaz remota que IWDFDevice2::CreateRemoteInterface creó y llamar a la función Release de la interfaz si anteriormente llamó a la función AddRef de la interfaz.

Si el controlador no proporciona esta función de devolución de llamada, el marco elimina el objeto de interfaz remota que creó IWDFDevice2::CreateRemoteInterface .

Para obtener más información sobre la función de devolución de llamada de eventos OnRemoteInterfaceRemoval de un controlador, consulte Uso de interfaces de dispositivo en controladores basados en UMDF.

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,9
Encabezado wudfddi.h (incluya Wudfddi.h)

Consulte también

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval