Método IPnpCallbackRemoteInterfaceNotification::OnRemoteInterfaceArrival (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum recurso novo está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução aoda UMDF .]
A função de retorno de chamada de evento OnRemoteInterfaceArrival do 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.
Valor de retorno
Nenhum
Observações
Um driver baseado em UMDF pode registrar sua função opcional OnRemoteInterfaceArrival retorno de chamada de evento 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. |
| da Plataforma de Destino | Área de trabalho |
| versão mínima do UMDF | 1.9 |
| cabeçalho | wudfddi.h (inclua Wudfddi.h) |
Consulte também
IPnpCallbackRemoteInterfaceNotification
IWDFDevice2::CreateRemoteInterface