Método IRemoteInterfaceCallbackRemoval::OnRemoteInterfaceRemoval (wudfddi.h)

[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

A função de retorno de chamada de evento OnRemoteInterfaceRemoval de um driver baseado em UMDF notifica o driver de que ele não pode usar uma interface de dispositivo porque a interface foi removida.

Sintaxe

void OnRemoteInterfaceRemoval(
  [in] IWDFRemoteInterface *pWdfRemoteInterface
);

Parâmetros

[in] pWdfRemoteInterface

Um ponteiro para a interface IWDFRemoteInterface de um objeto de interface remota que representa uma interface do dispositivo. O driver obtém esse ponteiro quando chama IWDFDevice2::CreateRemoteInterface.

Retornar valor

Nenhum

Comentários

A função de retorno de chamada de evento OnRemoteInterfaceRemoval de um driver deve fazer todas as tarefas específicas do driver necessárias para lidar com a remoção da interface do dispositivo. Além disso, o retorno de chamada deve excluir o objeto de interface remota que IWDFDevice2::CreateRemoteInterface criou e chamar a função Release da interface se ela tiver chamado anteriormente a função AddRef da interface.

Se o driver não fornecer essa função de retorno de chamada, a estrutura excluirá o objeto de interface remota que IWDFDevice2::CreateRemoteInterface criou.

Para obter mais informações sobre a função de retorno de chamada de evento OnRemoteInterfaceRemoval de um driver, consulte Usando interfaces de dispositivo em drivers baseados em UMDF.

Requisitos

Requisito	Valor
Fim do suporte	Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino	Área de Trabalho
Versão mínima do UMDF	1,9
Cabeçalho	wudfddi.h (include Wudfddi.h)

Confira também

IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival

IRemoteInterfaceCallbackEvent::OnRemoteInterfaceEvent

IRemoteInterfaceCallbackRemoval