Método IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (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 OnRemoteInterfaceArrival de um driver informa o driver quando uma interface do dispositivo está disponível.
Sintaxe
void OnRemoteInterfaceArrival(
[in] IWDFRemoteInterfaceInitialize *pWdfRemoteInterfaceInit
);
Parâmetros
[in] pWdfRemoteInterfaceInit
Um ponteiro para a interface IWDFRemoteInterfaceInitialize que identifica a interface do dispositivo que chegou.
Retornar valor
Nenhum
Comentários
Um driver baseado em UMDF pode registrar sua função opcional de retorno de chamada de evento OnRemoteInterfaceArrival chamando IWDFDevice2::RegisterRemoteInterfaceNotification.
O driver pode usar métodos da interface IWDFRemoteInterfaceInitialize para determinar qual interface do dispositivo chegou.
Antes que o driver possa enviar solicitações de E/S para a interface do dispositivo, o driver deve fazer o seguinte:
- Chame IWDFDevice2::CreateRemoteInterface para criar um objeto de interface remota.
- Chame IWDFDevice2::CreateRemoteTarget para criar um objeto de destino remoto.
- Chame IWDFRemoteTarget::OpenRemoteInterface para conectar o objeto de interface ao objeto de destino remoto e abrir o destino remoto para operações de E/S.
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
IWDFDevice2::CreateRemoteInterface